Etkileşimli Canvas API referansı

Interactive Canvas API'yi arayüz oluşturmak için kullandığınız Konuşma İşleminizle birlikte, web uygulamanızdaki interactiveCanvas nesnesini kullanabilirsiniz.

Etkileşimli Tuval hakkında daha fazla bilgi için bkz. Etkileşimli Tuval dokümanlarına göz atın.

Yöntemler

hazır

ready(callbacks) returns undefined

Geri çağırmaları kaydetmek için, yüklendikten sonra Etkileşimli Tuval web uygulaması tarafından çağrılır.

Parametreler
callbacks InteractiveCanvasCallbacks

Yöntem geri çağırmaları içeren bir nesne.

sendTextQuery

sendTextQuery(textQuery) returns Promise<state>

Sohbet işlemine bir metin sorgusu gönderir.

Parametreler
textQuery string

Konuşma işlemine gönderilecek sorgu.

state string

Aşağıdakilerden biri:

READY: İstekler platform tarafından kabul edilebilir.

BLOCKED: Yayında bir sorgu var ve yeni sorgu atlanacak.

UNKNOWN: Mevcut sorgu durumu belirlenemedi.

getHeaderHeightPx

getHeaderHeightPx() returns Promise<height>

Ekranın üst kısmındaki üstbilginin yüksekliğini belirler.

Parametreler
height number

Piksel cinsinden yükseklik.

outputTts

outputTts(text, openMic) returns undefined;

SSML metnini çalar.

Parametreler
text string

SSML tarafından desteklenen dize.

openMic boolean

TTS çaldıktan sonra mikrofonun açılıp açılmayacağı.

createIntentHandler

createIntentHandler(intentId, callback) returns IntentHandler

NLU özel intent için intent işleyici oluşturur.

Parametreler
intentId string

Eylem Oluşturucu'da tanımlanan amaç adı.

callback function(MatchedIntent)

Amaç eşleştiğinde yürütülecek işlev.

IntentHandler object

expect() kullanılarak kaydedilebilen amaç işleyici nesnesi.

IntentHandler

Niyet işleyiciyi temsil eden bir nesne. expect() veya prompt() kullanılarak kaydedilebilir.

MatchedIntent

Eşleşen bir amaca yönelik verileri içeren nesne.

Yöntemler
getIntentArg(parameterName) function(string)

Eşleşen bir amacın intent parametresini alma yöntemi.

createNumberSlot

createNumberSlot(callback, hints?) returns Slot<number>

Sayı türünde bir alan oluşturur.

Parametreler
callback function(FilledSlot)

Alan doldurulduğunda yürütülecek işlev.

hints Hints

Kullanıcının bir boşluğu doldururken söyleyebileceği kısa kelimeler. hints. NLU sisteminin hangi yuvayı dolduracağına karar vermesine yardımcı olur.

Slot object

prompt() kullanılarak kaydedilebilen alan nesnesi.

createTextSlot

createTextSlot(callback, hints?) returns Slot<string>

Dize türünde bir alan oluşturur.

Parametreler
callback function(FilledSlot)

Alan doldurulduğunda yürütülecek işlev.

hints Hints

Kullanıcının bir boşluğu doldururken söyleyebileceği kısa kelimeler. hints. NLU sisteminin hangi yuvayı dolduracağına karar vermesine yardımcı olur.

Slot object

prompt() kullanılarak kaydedilebilen alan nesnesi.

createConfirmationSlot

createConfirmationSlot(callback, hints?) returns Slot<boolean>

Boole türünde bir alan oluşturur.

Parametreler
callback function(FilledSlot)

Alan doldurulduğunda yürütülecek işlev.

hints Hints

Kullanıcının bir boşluğu doldururken söyleyebileceği kısa kelimeler. hints. NLU sisteminin hangi yuvayı dolduracağına karar vermesine yardımcı olur.

Slot object

prompt() kullanılarak kaydedilebilen alan nesnesi.

createOptionsSlot

createOptionsSlot(options, callback, hints?) returns Slot<string>

Önceden tanımlanmış seçenekler listesinden bir alan oluşturur.

Parametreler
options array<Option>

Alan doldurulduğunda yürütülecek işlev.

callback function(FilledSlot)

Alan doldurulduğunda yürütülecek işlev.

hints Hints

Kullanıcının bir boşluğu doldururken söyleyebileceği kısa kelimeler. hints. NLU sisteminin hangi yuvayı dolduracağına karar vermesine yardımcı olur.

Slot object

prompt() kullanılarak kaydedilebilen alan nesnesi.

Alan

Doldurulacak bir alanı temsil eden nesne. expect() veya prompt() kullanılarak kaydedilebilir.

FilledSlot&lt;T&gt;

Doldurulmuş bir alanı temsil eden nesne.

Parametre
T boolean|number|string

Alan türü.

Option

Alan türü girişini temsil eden bir nesne.

Alanlar
key string

Alan türü girişinin benzersiz tanımlayıcısıdır.

synonyms array<string>

Alan seçeneğini belirlemek için kullanılan kelimelerin listesi.

İpuçları

Alanla ilgili ipuçlarını temsil eden bir nesne.

Alanlar
associatedWords array<string>

NLU sisteminin hangi yuvayı dolduracağına karar vermesine yardımcı olmak için kullanılan kelimelerin listesi.

bekle

expect(expectation) returns HandlerRegistration

Beklentiyi istemciye kaydeder. Amaç işleyicilerde ve alanlarda çağrılabilir.

Parametreler
expectation IntentHandler|Slot

Kaydedilecek amaç işleyici veya alan.

HandlerRegistration object

Kayıtlı amaç işleyici veya alan.

HandlerRegistration

Kayıtlı amaç işleyiciyi temsil eden nesne.

Yöntemler
deleteHandler() function

Beklenen intent işleyicinin kaydını siler.

clearExpectations

clearExpectations() returns undefined;

Önceden kaydedilmiş tüm amaç işleyicileri ve alanları silerek tüm beklentileri ortadan kaldırır.

istem

prompt(tts, expectation) returns Promise<Answer<T>>

Sağlanan TTS dizesiyle kullanıcıya istem gösterir ve beklentiyi istemciye kaydeder. Amaç işleyicilerde ve alanlarda çağrılabilir.

Parametreler
tts string

Kullanıcıya sağlanan beklentiyi istemek için kullanılan TTS dizesi.

expectation IntentHandler|Slot

Kaydedilecek amaç işleyici veya alan.

Answer<T> object

İsteme kullanıcı tarafından sağlanan yanıt.

Yanıt<T>

İsteme kullanıcı tarafından sağlanan yanıtı temsil eden nesne.

Alanlar
value boolean|number|string

Kullanıcı tarafından sağlanan cevabın değeri.

status string

Yanıt durumu.

Aşağıdakilerden biri:

ANSWERED: Kullanıcı, istemi yanıtlayarak.

NO_MATCH: Kullanıcıdan yanıt istemiş ve beklenen yanıtla veya beklenen başka bir amaçla eşleşmeyen bir yanıt vermiştir.

YIELD: Kullanıcı, isteme farklı bir amaçla yanıt verdi.

triggerScene

triggerScene(sceneName) returns Promise<TriggerSceneStatus>

Bir sahneyi tetikler.

Parametreler
sceneName string

Tetiklenecek sahnenin adı.

TriggerSceneStatus string

tetikleyiciScene() çağrısının durumu.

Aşağıdakilerden biri:

SUCCESS: İstek, sunucu tarafından başarıyla işlendi.

BLOCKED: İstek, yayındaki mevcut bir sorgu tarafından engellendi.

UNKNOWN: İsteğin durumu bilinmiyor.

setUserParam

setUserParam(key, value) returns Promise<undefined>;

İleti dizileri arasında geçirilen ve devam eden anahtar/değer çiftini ayarlar.

Parametreler
key string

Parametre anahtarı.

value object|array|boolean|number|string

Parametre değeri.

getUserParam

getUserParam(key) returns Promise<object|array|boolean|number|string>;

Belirli bir anahtarın varsa parametre değerini ve çağrının durumunu alır.

Parametreler
key string

Parametre anahtarı.

resetUserParam

resetUserParam() returns Promise<void>;

Tüm kullanıcı parametrelerini temizler.

setHomeParam

setHomeParam(key, value) returns Promise<undefined>;

İleti dizileri arasında geçirilen ve devam eden anahtar/değer çiftini ayarlar.

Parametreler
key string

Parametre anahtarı.

value object|array|boolean|number|string

Parametre değeri.

getHomeParam

getHomeParam(key) returns Promise<object|array|boolean|number|string>;

Belirli bir anahtarın varsa parametre değerini ve çağrının durumunu alır.

Parametreler
key string

Parametre anahtarı.

resetHomeParam

resetHomeParam() returns Promise<void>;

Tüm kullanıcı parametrelerini temizler.

setCanvasState

setCanvasState(state) returns undefined

Asistan'a, Canvas web uygulamasının durumunu güncellediğini bildirir. İlgili içeriği oluşturmak için kullanılan setCanvasState yöntemi bir değer döndürmez. Eyalet yüküne şuradan erişilebilir: conv.context.canvas.state mülkündeki her mülk.

Parametreler
state Object

Tuval uygulamasının JSON nesnesi olarak güncellenmiş durumu.

InteractiveCanvasCallbacks

Bu geri aramalar, bilgi veya isteklere yanıt verebilmeniz için bir yöntem sunar. Conversational Action'ınızdan, diğer yöntemlerle bilgi veya istekleriniz olabilir.

onUpdate

onUpdate(data) returns Promise|undefined

Görüşme İşleminden Canvas yanıtı gönderildiğinde çağrılır. TTS şu tarihte başlayacak: veya 10 saniye sonra zaman aşımına uğrar.

Parametreler
data Object

Webhook tarafından gönderilen veriler güncellendi.

onTtsMark

onTtsMark(markName) returns undefined

TTS oynatma sırasında çağrılan geri arama.

Her zaman tetiklenen özel işaretler:

  • START, TTS'nin başlangıcını belirtir.
  • END, TTS'nin sonunu belirtir.
  • ERROR, TTS çalınırken bir hata olduğunu gösterir.

Ayrıca, SSML ve <mark> etiketini kullanarak, aşağıdaki gibi özel işaretler de tanımlayabilirsiniz: <mark name="custom"/>.

Parametreler
markName string

TTS çalma sırasında çağrılan adı işaretleyin.

onInputStatusChanged

onInputStatusChanged(inputStatus) returns undefined

Canvas uygulamasına, Asistan giriş durumunun değiştiğini bildirir.

Parametreler
inputStatus Enum

Cihazdaki ses ve/veya metin girişi işlemenin durumu. Teneke Kutu aşağıdaki gibi olmalıdır:

  • LISTENING : Mikrofon açık.
  • IDLE : Mikrofon kapalı.
  • PROCESSING: Asistan şu anda aşağıdaki işlemi yürütüyor: emin olun (mikrofon kapalı).