メソッド
hosted-experience-methods
インスタンスを作成したら、それと対話して動的に動作を制御できます。以下のメソッドは、インスタンス（例：uneeqInstance）で利用可能です。
オプションについて詳しく知りたい場合は、設定オプションをご覧ください。
// コードスニペットサンプルをそのまま利用している場合
const uneeq = new Uneeq(uneeqOptions)
// uneeq で各種メソッドを呼び出せます。例：
// uneeq.cameraAnchorHorizontal('center', 500)
// 例としてuneeqInstanceと設定している場合
const uneeqInstance = new Uneeq(options)
// uneeqInstance で各種メソッドを呼び出せます。例：
// uneeqInstance.cameraAnchorHorizontal('center', 500)Digitalhuman Methods
init()
オプションを検証し、メッセージイベントハンドラを設定することで、インスタンスを初期化します。
uneeqInstance.init()cameraAnchorHorizontal(position, duration)
カメラに指定されたアンカーポジションへの移動を要求します。
パラメータ
position(string): 希望するカメラのアンカーポジション。leftrightcenter
duration(number): カメラ移動の所要時間をミリ秒で指定します。
uneeqInstance.cameraAnchorHorizontal('center', 500);cameraAnchorDistance(position, duration)
カメラに指定されたアンカーポジションへの移動を要求します。
パラメータ
position(string): 希望するカメラのアンカーポジション。close_uploose_close_uptight_medium_shotmedium_shotmedium_full_shotfull_shot
duration(number): カメラ移動の所要時間をミリ秒で指定します。
uneeqInstance.cameraAnchorDistance('close_up', 500);chatPrompt(prompt,addClosedCaption)
デジタルヒューマンにチャットプロンプトを送信します。
パラメータ
prompt(string): チャットプロンプトメッセージ。
addClosedCaption(boolean): プロンプトメッセージをクローズドキャプションに追加するかどうか。 デフォルト:false。
uneeqInstance.chatPrompt('こんにちは、お名前を教えてください。', true);speak(speech)
デジタルヒューマンに発話リクエストを送信します。これは進行中のスピーチを中断します。複数または重複した発話リクエストを送信しても、それらのリクエストがキューに入れられることはありません。
パラメータ
speech(string): デジタルヒューマンが話す発話文。
uneeqInstance.speak('こんにちは、デジタルヒューマンのソフィーです。お話ししましょう。');enableMicrophone()
ユーザーのマイクを有効にして音声録音を行います。
uneeqInstance.enableMicrophone();endSession()
現在のセッションを終了します。
uneeqInstance.endSession();pauseSpeechRecognition()
音声認識処理を一時停止します。これはユーザーのマイクをミュートすることに相当します。
uneeqInstance.pauseSpeechRecognition();resumeSpeechRecognition()
音声認識処理を再開します。これはユーザーのマイクをミュート解除することに相当します。
uneeqInstance.resumeSpeechRecognition();setCustomPromptMetadata(customMetadata)
チャットプロンプトのカスタムメタデータを設定します。
パラメータ
customMetadata(Object): チャット用のカスタムメタデータ。
uneeqInstance.setCustomPromptMetadata({"key":"value"});
uneeqInstance.setCustomPromptMetadata({"name":"john"})setLayoutMode(layoutMode)
インターフェースのレイアウトモードを設定します。
パラメータ
layoutMode(string):overlayfullScreencontained
uneeqInstance.setLayoutMode('fullScreen');setWebRtcStatsEnabled(enableMessages: boolean, enableLogs: boolean)
ビデオや音声の品質問題を診断するために、WebRTC のロギングをオン／オフにできます。enableLogs を有効にするとブラウザのコンソールに出力されます。これらのメッセージをプログラムで処理したい場合は enableMessages を有効にすると、メッセージがページに渡されて処理できるようになります。
enableMessages を有効にすると、ページは uneeqMessageType: "WebRtcStats" というキー/値ペアを含むメッセージを受け取ります。
uneeqInstance.setWebRtcStatsEnabled(true, true);stopSpeaking()
デジタルヒューマンに発話を停止するよう指示します。
uneeqInstance.stopSpeaking();unmuteDigitalHuman()
ブラウザの自動再生ポリシーによってミュートされている場合、デジタルヒューマンのミュートを解除します。
uneeqInstance.unmuteDigitalHuman();muteDigitalHuman()
デジタルヒューマンをミュートします。音声を再び受け取るには、unmuteDigitalHuman()を呼び出す必要があります。このミュート状態の画面上のインジケーターはありません。
uneeqInstance.muteDigitalHuman();updateDisplayContent(htmlContent)
コンテンツウィンドウに表示するHTMLコンテンツを設定します。
パラメータ
htmlContent(string): 表示するHTMLコンテンツ。
uneeqInstance.updateDisplayContent('<p>New Content</p>');null: HTMLコンテンツを非表示にする。
uneeqInstance.updateDisplayContent(null);setShowClosedCaptions(show)
クローズドキャプションを表示するかどうかを設定します。
パラメータ
show(boolean): クローズドキャプションを表示する場合はtrue、そうでない場合はfalse。
uneeqInstance.setShowClosedCaptions(true);setShowUserInputInterface(show)
ユーザー入力インターフェース（テキスト/音声入力UI）を表示するかどうかを設定します。
パラメータ
show(boolean): ユーザー入力インターフェースを表示する場合はtrue、表示しない場合はfalse。
uneeqInstance.setShowUserInputInterface(true);startSession()
デジタルヒューマンとのセッションを開始します。
uneeqInstance.startSession();機能拡張 Dhx Methods
dhxInit(options)
デジタルヒューマンエクスペリエンス（DHX）の初期化を行います。UneeQインスタンスと各種設定を統合し、DHXの機能を使用可能にします。
通常、DHXはDOMContentLoadedイベントで自動的に初期化されます。このメソッドは、そのタイミングでwindow.dhxOptionsが設定されていなかった場合や、動的に設定を変更したい場合にのみ使用してください。
パラメータ
options(object): DHXの設定オプション。UneeQインスタンスや各種フィーチャーの有効/無効設定を含む。
const dhxOptions = {
"uneeq": uneeqInstance,
"customStt": true,
"stillcam": true,
"showStillcamWipe": false
}
window.dhxInit(dhxOptions);checkDhxOptions()
現在のDHX設定オプションをコンソールに表示し、設定オブジェクトを返します。デバッグや設定確認に使用されます。
window.checkDhxOptions();speakQueue.enqueue(text, addCaption)
デジタルヒューマンの発話をキューに追加し、順次実行します。複数の発話を連続して実行する場合に使用されます。
通常提供されているuneeqInstance.speakメソッドは、1回目の発話が終了する前に2回目のリクエストを行うと、2回目のリクエスト時点で1回目の発話を停止して次の発話処理を開始します。
この動作により発話が途中で中断される問題を解決するため、キューシステムによる順次実行機能を提供しています。
パラメータ
text(string): デジタルヒューマンに発話させるテキスト。
addCaption(boolean, optional): キャプション表示の有無。デフォルト値はtrue。
// 基本的な使用方法
window.speakQueue.enqueue("こんにちは");
// キャプションを表示しない場合
window.speakQueue.enqueue("こんにちは", false);
// 複数の発話を順次実行
window.speakQueue.enqueue("最初の発話です");
window.speakQueue.enqueue("次の発話です");
window.speakQueue.enqueue("最後の発話です");dhxShowStillcamWipe(show)
静止画キャプチャ機能のワイプエフェクト表示を動的に切り替えます。dhxOptions.stillcam機能が有効な場合にのみ使用可能です。
パラメータ
- show (boolean): ワイプエフェクトを表示する場合はtrue、非表示にする場合はfalse。
// ワイプエフェクトを表示
window.dhxShowStillcamWipe(true);
// ワイプエフェクトを非表示
window.dhxShowStillcamWipe(false);getSessionDuration()
現在のセッションの経過時間を取得します。dhxOptions.timeDetailオプションが有効な場合にのみ使用可能です。セッションがアクティブでない場合は値は返却されません。
const duration = window.getSessionDuration();
console.log(duration); // セッション経過時間（秒）最終更新日 December 26, 2025