Aora Bot
  • 简体中文

      • 组件

      React 层刻意很小。大部分工作发生在引擎里；这些组件决定何时动画、何时共享动画，以及何时干脆不动。

      核心

      CharacterMark角色单个动画角色。其余组件都建立在它之上。CharacterMarkMirror角色镜像几乎零成本地把正在运行的角色再画一遍。MarkStageProvider共享舞台让外观相同的角色共享同一份动画。useMarkCommands角色指令从树外给角色挂上事实与状态，带优先级和时限。

      头像

      AgentAvatar头像照片、群组簇或角色，自动选择其一。AvatarStack头像组交叠的群组成员，每一个都从后方抠出轮廓。UnreadBadge徽标与状态叠在头像上的计数与在线状态点。WorkingBadge忙碌徽标智能体忙碌时叠在头像上的小转圈徽标。AvatarEditor头像编辑器角色、生成图或上传裁切，收在一个对话框里。

      活动与特效

      ActivityMark活动标记角色与文案来自同一数据源，表示智能体正在做什么。ActivityTicker活动跑马交叉淡入的单行文字，不会把行高撑乱。ConfettiLayer彩纸层独立的庆祝粒子，不依附任何角色。OccupancyList占用列表哪些智能体占用了哪些共享资源，一行一个。

      HUD

      HudPlateHUD 底盘围绕带表盘角色的说明底盘：标题、数值、单位。AgentHud智能体 HUD把一个智能体的仲裁状态和表盘放到底盘上。

      智能体

      AgentStateProvider智能体状态给一棵角色树共用一个仲裁器：会话、优先级、最短驻留。useIdleSleep空闲入睡空闲久了先困倦，再睡着。SpriteMark精灵图手绘精灵图，讲和矢量角色同一套协议。

      编辑与模板

      CharacterPicker角色选择器形状与墨色选择器，选中环跟随形状本身。AgentCharacterPicker暂存选择器先暂存、确认后才生效的角色选择器。CompactCharacterPicker紧凑选择器为狭小空间折成一行的选择器。TemplateDialog模板对话框智能体模板的名称、指令与可见性，附分享卡片。usePublishMark发布状态角色在保存中、已发布、庆祝之间的状态弧线。

      场景

      RestrictedScene受限场景受限、离线或未授权状态，由边框里的角色来讲。BootLoop启动序列启动序列，以及加载行用的占位角色。CastStage群像舞台多个角色按脚本编排的一场戏。DemoDesktop引导页组件引导页组件：桌面框、任务气泡、卡片、交接、输入框。

      其他

      LocaleProvider多语言为下方所有组件提供语言。

      它们如何关联

      四层。引擎对 React 一无所知；核心把它包成组件，并决定何时共享动画；智能体层把协议编号喂给核心；其余一切由这两层组合而来。

      怎么选组件

      单独一个角色。 CharacterMark。

      很多角色，其中大多数长得一样。 MarkStageProvider 加 StagedMark。每种不同的形状-状态组合一个引擎，其余用镜像。

      用户或智能体的头像。 AgentAvatar。它在照片、群组簇和角色之间替你选择，并从 id 推导稳定外观，所以你不必存储一份。

      会报告自己在做什么的智能体。 AgentStateProvider 加 CharacterMark。钩子和中继讲的是情绪协议；仲裁器决定脸上显示哪一个会话。

      脸旁边要有一个数字。 任何角色都有 hud，规格由协议携带；需要标题和数值并排时用 HudPlate，两者都该由 provider 提供时用 AgentHud。

      同一个智能体同时画在几个地方。 角色指令——事实只发布一次，这个智能体的每一个名册行、头像和活动行都跟着走。

      让人选择或编辑外观。 设置表单里用 CharacterPicker；对话框里用 AgentCharacterPicker；注册表单旁用 CompactCharacterPicker；还允许上传图片时用 AvatarEditor；外观属于一个正在创建的模板时用 TemplateDialog。

      一整个场景。 死胡同用 RestrictedScene，不确定时长的等待用 BootLoop，有脚本的表演用 CastStage，引导流程用引导页组件。

      用手绘吉祥物代替程序化角色。 SpriteMark，用同一套协议编号索引帧。

      虚拟列表里的几百个。 都不用——用 renderAvatarDataUrl 渲染图片。

      全部导出

      一页看完：API 索引。

      接下来