TypeScript のサポート

KlleonSDK.d.ts

type LogLevelType = "debug" | "info" | "warn" | "error" | "silent";
type VoiceCodeType = "ko_kr" | "en_us" | "ja_jp" | "id_id";
type SubtitleCodeType = "ko_kr" | "en_us" | "ja_jp" | "id_id";
type Status =
  | "IDLE"
  | "CONNECTING"
  | "CONNECTING_FAILED"
  | "SOCKET_CONNECTED"
  | "SOCKET_FAILED"
  | "STREAMING_CONNECTED"
  | "STREAMING_FAILED"
  | "CONNECTED_FINISH"
  | "VIDEO_LOAD"
  | "VIDEO_CAN_PLAY";

interface InitOption {
  sdk_key: string;
  avatar_id: string;
  voice_code?: VoiceCodeType; // 発話音声の言語設定
  subtitle_code?: SubtitleCodeType; // 字幕の言語設定
  voice_tts_speech_speed?: number; // 発話速度の調整
  enable_microphone?: boolean; // ブラウザのマイク許可なしで接続
  log_level?: LogLevelType; // ログレベルの設定
}

export declare enum ResponseChatType {
  TEXT = "TEXT", // キャラクターメッセージ
  STT_RESULT = "STT_RESULT", // ユーザーの音声メッセージ
  RATE_LIMIT = "RATE_LIMIT", // キャラクターメッセージ受信無効化
  WAIT = "WAIT", // チャット開始待機中
  WARN_SUSPENDED = "WARN_SUSPENDED", // ユーザーの操作がない場合、10秒後にチャット停止の警告
  DISABLED_TIME_OUT = "DISABLED_TIME_OUT", // 一定時間操作がない場合チャット停止
  TEXT_ERROR = "TEXT_ERROR", // ユーザーメッセージの送信失敗
  TEXT_MODERATION = "TEXT_MODERATION", // ユーザーが不適切な言葉を入力
  ERROR = "ERROR", // サーバーエラー発生
  RESPONSE_IS_ENDED = "RESPONSE_IS_ENDED", // キャラクターメッセージ送信完了
  WORKER_DISCONNECTED = "WORKER_DISCONNECTED", // ストリーミング終了
  ACTIVATE_VOICE = "ACTIVATE_VOICE", // 音声認識開始
  PREPARING_RESPONSE = "PREPARING_RESPONSE", // キャラクターが回答を準備中
  EXCEED_CONCURRENT_QUOTA = "EXCEED_CONCURRENT_QUOTA", // 同時接続ユーザー数の上限を超過
}

interface ChatData {
  message: string;
  chat_type: ResponseChatType;
  time: string;
  id: string;
}

interface ChangeAvatar {
  avatar_id: string;
  subtitle_code?: SubtitleCodeType;
  voice_code?: VoiceCodeType;
  voice_tts_speech_speed?: number;
}

interface KlleonChat {
  init: (option: InitOption) => Promise<void>;
  onChatEvent: (callback: (data: ChatData) => void) => void;
  onStatusEvent: (callback: (status: Status) => void) => void;
  destroy: () => void;
  sendTextMessage: (msg: string) => void;
  startStt: () => void;
  endStt: () => void;
  cancelStt: () => void;
  echo: (message: string) => void;
  startAudioEcho: (audio: string) => void;
  endAudioEcho: () => void;
  changeAvatar: (options: ChangeAvatar) => Promise<void>;
  clearMessageList: () => void;
  stopSpeech: () => void;
}

declare global {
  interface Window {
    KlleonChat: KlleonChat;
  }
}

declare module "react" {
  namespace JSX {
    interface IntrinsicElements {
      "avatar-container": React.DetailedHTMLProps<
        Omit<React.HTMLAttributes<HTMLElement>, "className"> & {
          class?: string;
        },
        HTMLElement
      >;
      "chat-container": React.DetailedHTMLProps<
        Omit<React.HTMLAttributes<HTMLElement>, "className"> & {
          class?: string;
        },
        HTMLElement
      >;
    }
  }
}

tsconfig.json

// tsconfig.json
{
    "compilerOptions": {...},
    "include": [KlleonSDK.d.ts]
}