从零接入数字角色 API

// 用嵌入 Token 初始化（不暴露 API Key）
const pet = new DigitalPetSDK({
  token: "embed_xxx",         // 在控制台生成的嵌入 Token
  endpoint: "https://api.hwavatar.com" // 平台地址
});

// 加载角色到指定容器
await pet.loadCharacter("char_xxx", {
  container: document.getElementById("pet-container"),
  width: 320,
  height: 480
});

// 让角色直接说话（豆包 TTS 自动播报）
pet.speak("你好，很高兴认识你！");

// 对话并说话（调 /api/chat 流式拿回复 → 自动 TTS）
await pet.chatAndSpeak("你今天心情怎么样？");

// 开启会话（多次对话复用，自动维护历史）
const session = await pet.startSession();
session.on("reply", (text) => console.log("角色回复：", text));
await session.send("讲个笑话吧");

// 停止当前语音
pet.stop();

// 静态方法：列出可用角色
const chars = await DigitalPetSDK.listCharacters("https://api.hwavatar.com");

pet.on("ready", () => console.log("角色加载完成"));
pet.on("speaking", (data) => console.log("流式中：", data.partial));
pet.on("reply", (text) => console.log("完整回复：", text));
pet.on("idle", () => console.log("说话结束"));
pet.on("error", (err) => console.error("错误：", err));

POST /api/chat
Authorization: Bearer hw-chr-xxx
Content-Type: application/json

{
  "message": "你今天心情怎么样？"
}

# 响应：text/plain 流式（逐字下发）
# Transfer-Encoding: chunked
# Content-Type: text/plain; charset=utf-8
#
# 今天心情超级好呀～因为见到了你！

GET /api/characters

# 响应：
{
  "characters": [
    {
      "id": "char_xxx",
      "name": "示例角色",
      "desc": "角色简介…",
      "type": "2D",
      "price": 29.9,
      "status": "live"
    }
  ]
}

# 创建密钥
POST /api/keys
Authorization: Bearer <session-token>

# 响应（完整 Key 仅显示一次）：
{ "ok": true, "key": "hw-chr-9xK2mQ7vB3nR8sT1wY4zA6cD5eF0gH2j" }

# 列出密钥
GET /api/keys
Authorization: Bearer <session-token>

# 删除密钥
DELETE /api/keys/key_xxx
Authorization: Bearer <session-token>

Content-Type: text/plain; charset=utf-8
Cache-Control: no-cache
X-Accel-Buffering: no
Transfer-Encoding: chunked

// JavaScript 流式读取
const res = await fetch("/api/chat", { /* ... */ });
const reader = res.body.getReader();
const decoder = new TextDecoder();
let fullText = "";

while (true) {
  const { done, value } = await reader.read();
  if (done) break;
  const chunk = decoder.decode(value, { stream: true });
  fullText += chunk;
  updateBubble(fullText);  // 实时更新气泡
}
speak(fullText);  // 流结束后触发 TTS