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가 전송될 때 호출됩니다. 후(After) 함수 호출이 종료되면 TTS가 즉시 시작됩니다.

매개변수
data Object

웹훅에서 전송된 데이터를 업데이트했습니다.

onTtsMark

onTtsMark(markName) returns undefined

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

항상 트리거되는 특수 표시:

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

다음 명령어를 사용하여 커스텀 표시를 정의할 수도 있습니다. SSML<mark> 태그(예: <mark name="custom"/>)

매개변수
markName string

TTS 재생 중에 호출되는 이름을 표시합니다.