Skip to content

通讯场景

通讯场景模拟聊天应用界面,支持多种消息类型,用于实现角色之间的对话和互动。

场景属性

属性说明
myIcon我的头像
dialogs对话列表(联系人)
appTime顶部时间显示
appBattery电量百分比(0-100)
appSignal信号强度(0-100)
showTime / hideTime应用界面出现/隐藏时间
appSettings应用外观预设(手机模型、摄像头样式等)

对话(Dialog)

每个对话代表一个联系人会话,包含:

属性说明
icon联系人头像
messages消息列表
unRead未读标记
time消息时间
_asyncScript对话脚本(show/run)

消息类型

文本消息

普通聊天文字,支持:

  • username:发送者名称(群聊时显示)
  • icon:消息头像(覆盖对话头像)
  • me:标记为"我的消息"(靠右显示)
  • delay:延迟出现时间(ms)

可选消息

供用户选择的回复选项,支持:

  • messages:选项列表(每个选项为一条文本消息)
  • 选中后激活后续消息链
  • 可设定 target 直接跳转场景

通知消息

系统通知样式,居中显示灰色文字。支持 delay 延迟。

转账消息

模拟转账交互:

  • money:金额
  • unit:货币单位(默认 ¥)
  • info:底部说明文字
  • received:标记为收款,自动匹配上一个同金额的转账

媒体消息

发送图片或视频,支持 media 属性,点击可全屏查看。

语音消息

音频播放条,支持 audio 属性。

文件消息

模拟文件分享:

  • fileIcon:文件图标
  • size:文件大小文字
  • media:点击后的预览(弹出媒体)

表情消息

透明贴纸,face 属性接受 webm 视频或 png 图片。聊天界面默认背景色为 #ededed

链接消息

模拟链接分享卡片:

  • favicon:链接图标
  • info:说明文字
  • media:预览媒体(模拟打开后的效果)
  • target:链接内容为空时直接跳转场景
  • owner / ownerImage:链接来源信息

事件消息

嵌入在可选消息中的事件节点,激活后支持:

  • messages:后续消息列表
  • target:目标场景

节点显示

若事件消息设定了 target,需将该消息引入到通讯场景的 事件 列表中,才能在节点面板中显示后续路径。

脚本

对话和消息均支持脚本,可设置 show(是否显示)和 run(运行时逻辑)函数。