Skip to content

活动映射 ​

Avatar 通过内置映射层,将准入的 Runtime 活动与情绪转换为当前渲染后端的画面表现。模型创作者只需配置后端能力与名称映射;将 JavaScript 文件放入模型目录不会注册自定义处理器。

当前输入路径 ​

  1. 受保护的 App 会话读取已授权的 Agent 与 Conversation。
  2. SDK 驱动将准入的具身(embodiment)更新转换为 Avatar 本地输入,包括 runtime.agent.presentation.activity_requested 和 runtime.agent.state.emotion_changed。
  3. Avatar 校验目标,并通过内置 adapter 完成映射。
  4. 当前渲染后端执行受支持的输出,或直接返回失败;不支持的行为不会用待机动画替代后再报告成功。

活动标识与语义由 Runtime 统一定义。Avatar 的 route ID 来自生成动作路由目录,不会新增 Runtime 活动标识或公共 APML 标签。

模型配置 ​

请通过经校验的能力配置声明模型支持与不支持的路由及物理限制。需要映射模型特定名称时,请使用受控的 mapping sidecar,详见模型能力配置与生成动作提供器。

Live2D 参数扩展仅供 Avatar 内置转换层在收窄后端类型后调用,不是创作者脚本 API。当前 Avatar 不提供 NAS 创作者加载器、沙盒、ctx 注入或目录热重载。

本地观察事件 ​

Avatar 使用 avatar.activity.start、avatar.activity.end 及取消事件表示本地处理结果。这些观察事件不会提交对话轮次,也不会改变 Runtime 语义,详见Avatar 事件。

Source Basis ​

Nimi 文档:可安装、开源、本地优先的个人 AI 产品。