init()

SDKを初期化し、アバター接続を開始します。

使用方法

await SDK.init(options);

InitOption

パラメータ	型	必須	デフォルト	説明
sdk_key	string	O	-	SDK認証キー
avatar_id	string	O	-	アバターID
log_level	LogLevel	X	"debug"	ログレベル
language	LanguageCode	X	"ko_kr"	言語コード（TTS音声 + 字幕）
enable_microphone	boolean	X	true	マイク有効化（STT用）
auto_send	boolean	X	false	false（Push to Send）: startListening/endListeningで手動制御。true（Auto Send）: STT常時有効、サーバーVADが発話を検知し自動応答。Auto Sendは対応アバターでのみ動作します。事前にアバターの対応状況をご確認ください。
stt_only	boolean	X	false	STT専用モード。trueの場合、アバターは応答せずSTT結果のみ返します。falseの場合、STT結果を返し、その結果に基づいてアバターが応答します。

LogLevel

ブラウザコンソールに出力されるログレベルを制御します。設定したレベル以上のみ出力されます。

値	出力範囲	用途
"debug"	debug, info, warn, error	開発中の詳細デバッグ（デフォルト）
"info"	info, warn, error	主要イベントのみ確認（接続完了、初期化など）
"warn"	warn, error	潜在的な問題のみ確認
"error"	error	エラーのみ出力
"silent"	なし	コンソール出力を完全に無効化

LanguageCode

アバターのTTS音声および字幕言語を指定します。

値	言語
"ko_kr"	韓国語（デフォルト）
"en_us"	英語
"ja_jp"	日本語
"id_id"	インドネシア語

接続フロー

エラー処理

失敗時は内部クリーンアップ後に IDLE にリセットし、Error をthrowします。

try {
  await SDK.init(options);
} catch (error) {
  // error.messageに失敗原因が含まれます
  // "Failed to connect: ..."          → SDKキー検証またはWebSocket接続失敗
  // "Failed to connect streaming: ..." → ストリーミング接続失敗
  console.error(error.message);
}

• init/destroy進行中に再呼び出しした場合、前の操作の完了を待ってから実行されます（Mutex直列化）。