InteractiveCanvas (Dialogflow)

interactiveCanvas 객체는 웹 앱 내에서 사용할 수 있는 대화 작업의 인터페이스입니다.

방법

준비됨

ready(callbacks) returns undefined

콜백을 등록하기 위해 로드된 후 Interactive Canvas 웹 앱에서 호출합니다.

매개변수
callbacks InteractiveCanvasCallbacks

메서드 콜백을 포함하는 객체입니다.

sendTextQuery

sendTextQuery(textQuery) returns Promise<state>

대화 작업에 텍스트 쿼리를 보냅니다.

매개변수
textQuery string

대화 작업에 전송할 쿼리입니다.
state string

다음 필드 중 하나는 사용해야 합니다.

READY: 플랫폼에서 요청을 수락할 수 있습니다.

BLOCKED: 처리 중인 쿼리가 있으며 새 쿼리가 삭제됩니다.

UNKNOWN: 현재 쿼리 상태를 확인할 수 없습니다.

getHeaderHeightPx

getHeaderHeightPx() returns Promise<height>

디스플레이 상단에 있는 헤더의 높이를 결정합니다.

매개변수
height number

높이(픽셀)입니다.

InteractiveCanvasCallbacks

이러한 콜백은 대화 작업의 정보나 요청에 응답하는 방법을 제공하고, 메서드는 대화 작업에 정보나 요청을 전송하는 방법을 제공합니다.

onUpdate

onUpdate(data) returns undefined

대화 작업에서 HtmlResponse가 전송될 때 호출됩니다. 함수 호출이 끝나면 TTS가 즉시 시작됩니다.

매개변수
data Object

웹훅에서 전송된 업데이트된 데이터

onTtsMark

onTtsMark(markName) returns undefined

TTS 재생 중에 호출되는 콜백입니다.

항상 트리거되는 특수 표시는 다음과 같습니다.

  • START은 TTS의 시작을 나타냅니다.
  • END는 TTS의 끝을 나타냅니다.
  • ERROR는 TTS 재생 오류를 나타냅니다.

SSML 및 <mark> 태그(예: <mark name="custom"/>)를 사용하여 맞춤 표시를 정의할 수도 있습니다.

매개변수
markName string

TTS 재생 중에 호출된 표시 이름입니다.