直播

2.2.0 新增功能,2.1.2 及更早版本中没有。

接收 Twitch·CHZZK·SOOP 的观众事件和 Discord 朋友的反应,让角色做出反应。直播联动是 Pro 功能,目前为测试版 (Beta)。在实际直播中遇到问题时,请通过错误报告告诉我们。

直播页面有两个选项卡。

选项卡 作用
互动 设置事件到来时要做什么。包括简易设置、节点编辑器、倒下·打赏显示·测试。
连接 连接平台账号和 Discord 频道,并开启 WebSocket 与远程联播会话。
直播 › 连接选项卡的平台列表
直播 › 连接选项卡的平台列表

连接

连接 Twitch · CHZZK · SOOP

  1. 打开直播 → 连接。
  2. 打开要连接的平台的开关。
  3. 在浏览器打开的平台登录页面中,用自己的直播账号登录并允许权限。
  4. 卡片上显示已连接后,就可以接收事件了。
Twitch 卡片的悄悄话·调试日志设置
Twitch 卡片的悄悄话·调试日志设置
平台 可接收的事件
Twitch 频道积分兑换、聊天、关注、订阅(含赠送·订阅留言)、Bits、突袭、热度列车、悄悄话
CHZZK 聊天、赞助(聊天赞助·视频赞助)、订阅
SOOP 聊天、星气球、广告气球、视频气球、贴纸、订阅、礼物

关闭开关后不再接收事件。已保存的登录信息和规则不会被删除。开启调试日志后,收到的事件会详细记录在诊断日志中。

Twitch·CHZZK·SOOP 登录会经由 Avatar Live 服务器完成连接。登录信息只保存在你自己的电脑上,服务器不会保留。

连接 Discord

不看直播的朋友,也可以在 Discord 频道里用按钮或 /反应 命令让角色动起来。仅在 Avatar Live 应用运行时有效。

Discord 卡片的反应列表
Discord 卡片的反应列表

1. 添加 Discord 应用

打开添加 Avatar Live Discord 应用,选择要添加到的位置。应用只请求命令(applications.commands)权限,不会读取消息,也不会管理服务器。

添加到 适用情况
添加到服务器 在自己的 Discord 服务器频道中使用。需要服务器管理权限。朋友们无需安装任何东西。
添加到我的账号 没有服务器或在群组私信中使用。要在群组私信中直接输入命令,那位朋友也需要把应用添加到自己的账号。没有安装的朋友可以点我发出的按钮。

2. 连接频道

  1. 在应用中打开直播 → 连接 → Discord 开关。
  2. 点击生成连接码。8 位代码会显示 10 分钟。
  3. 在要连接的 Discord 频道中选择 /连接 命令,在代码栏中填入该代码并发送。
  4. 应用中弹出“连接 Discord 频道”窗口后,确认服务器和频道名称,然后点击连接。
  5. 该频道会出现在已连接的频道列表中。

代码只能使用一次。已被他人连接的频道无法连接。

3. 发布反应按钮

  1. 在已连接的频道中发送 /面板。反应列表中的反应会以按钮形式发出。
  2. 朋友点击按钮或用 /反应 选择反应后,处理该反应的规则就会运行。
  3. Discord 消息中会显示谁做了什么。

在反应列表中为每个按钮设置名称·表情符号·数值·规则。数值是规则的最小·最大个数条件所看的数。点击规则会依次切换规则,所选规则的 Discord 反应触发会被开启。

Discord 命令

命令 谁 作用
/连接 代码: 我 把此频道连接到我的 Avatar Live。
/断开连接 我·服务器管理员 断开此频道的连接。
/面板 我·服务器管理员 发出反应按钮。群组私信中也可以。
/反应 朋友 选择一个反应。不选时为第一个反应。
/积分 /签到 /赠送 /排行榜 朋友 查看、收集和分享积分游戏的积分。
/轮盘 /老虎机 /高低牌 /二十一点 /对决 /预测 /抽奖 /赛跑 /问答 /首领战 朋友 积分游戏的小游戏。

Discord 客户端语言为英语时,命令也会显示为 /link、/unlink、/panel、/react 等英文名称。

积分游戏的规则和积分数值在 Discord 卡片的积分游戏中设置。积分按频道保存在这台电脑上。

Discord 与应用之间由开发者服务器转发。朋友的 Discord 名称和头像会传到我的应用,用于显示和贴纸。应用不会自行在 Discord 上发帖,只回应朋友的命令。

WebSocket

WebSocket 卡片的端口设置
WebSocket 卡片的端口设置

让其他程序在这台电脑内与 Avatar Live 互相收发事件。默认关闭,端口为 19190。只有同一台电脑上的程序可以通过 ws://127.0.0.1:端口 连接。收发的内容用节点编辑器的 WebSocket 节点处理。

远程联播

将不同电脑上正在活动的角色放到同一个工作室场景中。所有参与者必须使用 Pro,并安装支持远程会话的相同版本。

打开直播 → 连接最下方的会话卡片。由一名房主开启服务器,其他参与者使用房主提供的地址加入。

房主:创建房间

设置示例连接地址的会话画面
设置示例连接地址的会话画面
  1. 展开开启服务器。
  2. 设置自己的名称、密码和最大人数。
  3. 打开服务器开关。
  4. 将连接地址和密码告知参加者。
设置 作用
端口 用于连接的端口号,默认为 47700。
最大人数 包括房主在内的参加人数上限。
密码 加入房间时必须输入的密码。
服务器开关 打开或关闭房间。关闭后其他参与者也会断开。
我的地址 房主电脑的内网地址。不同家庭的朋友应使用公网地址和端口。

如果朋友无法加入,请查看连接故障排查。

参与者:加入房间

  1. 展开加入。
  2. 在地址栏输入房主提供的地址:端口。
  3. 输入自己的名称和房间密码。
  4. 打开连接开关。首次进入时,请阅读弹出的入场说明并同意一次。
  5. 检查参与者列表是否显示彼此的名称。

离开时关闭连接开关。

角色显示与布局

参加者显示、角色共享和位置设置
参加者显示、角色共享和位置设置
设置 打开或修改后的效果
与会话共享数据 与会话参与者收发角色数据的一个开关。默认关闭。
单独设置 展开后可分别设置显示对方角色、发送我的角色。
替代角色 无法使用对方模型时选择本机角色替代显示。
布局同步 应用房主安排的位置及每个人单独调整的偏移。
锁定位置 房主限制参与者自行修改位置、旋转及大小。
位置、旋转、大小 调整当前选中的参加者布局。
重新查找 在本地文件夹重新查找自己已合法拥有的相同 VRM。

你自行调整的远端角色位置可能只对自己的画面生效。多人需要看到相近的排列时,请使用布局同步。

发送角色之前

角色、服装和道具是否允许传输,取决于原作者的使用条款。购买 Pro 或对数据加密,并不等于取得共享许可。禁止再分发的 VRM 不会被传输。

若不允许传输,请保持发送我的角色数据关闭,并使用替代角色。详细责任与权限请参考内容使用条款。

连接故障排查

首先确认房主服务器已开启、地址和端口及密码正确,并且所有参加者使用相同的兼容版本。

另一户家庭的朋友无法连接——端口转发

需要在房主路由器中,将外部连接转发至房主电脑。

  1. 查看房主电脑的 IPv4 地址。
  2. 在路由器管理页打开端口转发/端口映射。
  3. 添加以下规则:
设置 应填写的值
内部 IP 房主电脑的 IPv4 地址
外部端口 47700
内部端口 47700
协议 TCP 和 UDP 均需允许

如果应用内修改了端口号,应同步修改上述两个端口。外部朋友使用房主路由器的公网 IP 和端口连接。以 192.168 开头的内网地址无法直接从另一家庭连接。

地址与端口正确但没有回应——防火墙

确认 Windows 防火墙允许 Avatar Live 通信。如需手动创建入站规则,应允许会话端口的 TCP 与 UDP。不需要关闭整个防火墙。

如果房主电脑的内网 IP 变了,还需更新路由器的转发目标。使用路由器的 DHCP 地址保留可以减少地址变化。

端口转发及防火墙都正确仍无法连接——路由器与运营商

如果路由器的 WAN 地址为私有地址,或运营商使用 CGNAT,仅设置自己的路由器可能无法实现外网直连。请检查上级路由器或向运营商询问公网 IP 服务。

在同一 Wi-Fi 下通过公网 IP 测试可能因路由器不支持 NAT 回环而失败。请让位于另一网络的朋友进行测试。

会话数据说明

  • 由一位参加者的电脑充当房主服务器,并非将角色存储在 Avatar Live 的中央服务。
  • 经同意传输的角色数据使用 AES-256-GCM 加密,在房主及接收方电脑上临时缓存。
  • 会话结束或退出时,会清除临时缓存并丢弃解密密钥。
  • 仅凭加密缓存无法直接提取或恢复原始角色文件。
  • 实时姿态、表情和控制消息通过与角色文件不同的路径传输,不具备相同的端到端加密。
  • 文件加密传输不会赋予角色、服装或道具的再分发权。

互动

简易设置

简易设置是用一行写出“事件到来时这样反应”的列表。例如有人关注时投掷物体,收到 1 万韩元以上的打赏时向角色泼水。它是直播联动功能,需要 Pro,目前为测试版 (Beta)。

在直播 → 互动的简易设置卡片中创建。

简易设置列表与互动选项卡
简易设置列表与互动选项卡
行中显示的内容 含义
平台图标 此条目接收的平台。
名称 条目名称。最初会自动命名为“规则 1”等。
触发 → 动作 概括对哪个事件做什么。
▶ 发送一次模拟事件,立即测试。
⋯ 重命名·创建副本·启用/停用·删除菜单。右键点击行也可以打开。
开关 开启或关闭条目。

创建新条目

  1. 点击简易设置卡片的 +。
  2. 在平台步骤中开启要接收事件的平台。可以同时开启多个。
  3. 点击下一步。
  4. 在连接步骤中确认已登录该平台。尚未登录时,用登录按钮连接。
  5. 在投掷·贴纸·液体步骤中,分别选择要对哪些事件运行。没有选择事件的步骤不会创建。
  6. 点击创建,条目会添加到列表中。
简易设置的平台步骤
简易设置的平台步骤
连接步骤的登录提示
连接步骤的登录提示

留空的项目会用默认物体·声音·特效·贴纸文件夹填充,可以直接使用。详细数值可在创建后展开条目修改。

示例

想做的事 触发 动作
有人关注时投掷物体 Twitch 关注 投掷
1 万韩元以上的打赏时泼水 CHZZK 赞助,最低金额 10000 液体
星气球 100 个以上时泼水 SOOP 星气球,最低个数 100 液体
用 Discord 朋友的反应投掷 Discord 反应 投掷
用频道积分切换灯光 Twitch 奖励,奖励标题 灯光

示例条目的动作设置在投掷·液体·倒下中详细说明。

展开条目

点击行右侧的箭头即可展开条目。

展开频道积分奖励触发的条目
展开频道积分奖励触发的条目
触发

触发按平台分组。用平台旁的 + 添加触发,一个条目中可以同时放入多个平台的触发。

触发 条件
奖励 (Twitch) 奖励标题相同的频道积分奖励
聊天 消息中必须包含的文字
Bits·赞助·星气球 最低金额·个数,最高金额·个数
订阅 新订阅·续订·赠送订阅
Discord 反应 要处理的反应,最小·最大个数
Discord 小游戏结果 游戏、仅大奖时、最少获得积分

展开测试值,可以设置 ▶ 测试时发送的昵称·金额·消息。

动作
投掷动作的物体·起点·终点设置
投掷动作的物体·起点·终点设置
动作 作用
快捷操作 运行一个快捷操作。
单次动画 播放一次单次动画。
投掷 向角色投掷道具。可以按打赏金额增加数量。
液体 泼洒水·牛奶等液体。
贴纸 把图片贴到角色上。也可以使用观众头像。
灯光 暂时开关灯光,或改变颜色·亮度·效果·预设,在设定的时间后恢复。
头像 关闭追踪、循环舞蹈、暂时摆姿势。

由简易设置条目和节点编辑器运行的角色反应。任何角色·相机都可以使用。它是直播联动功能,需要 Pro,目前为测试版 (Beta)。

投掷

把道具库中的物体投向角色。被击中时,角色会在站立状态下被推开,然后回到原位。

设置 作用
物体 通过缩略图·分类·搜索选择要投掷的物体。选择多个时,每次随机投掷其中一个。
起点 设置从画面外·边缘·头顶·脸前中的哪里飞来。
终点 瞄准身体任意处,或头·胸·手等部位。
速度·重量·大小 设置击中的快慢和力度,以及物体大小。
数量 一次投掷的数量和间隔。开启按金额后,数量会随打赏金额增加。
声音 投出时·命中时的声音。也可以放入自己的声音文件。
特效 命中时显示冲击·闪光·星星·尘土·爱心·水滴·彩纸特效。
被击中时的表情 选择被击中期间的表情。
更多 设置重力·旋转·存在时间·命中后消失·命中后粘住。
液体
液体动作的速度·流量·停止设置
液体动作的速度·流量·停止设置

从水·果汁·牛奶·蜂蜜·史莱姆·墨水·黄金中选择液体种类,泼向角色。液体会从命中处顺着身体流下,角色会暂时显得湿润,然后变干。

设置 作用
起点·终点 液体流出的位置和瞄准的位置。也可以从脸前泼洒。
速度·流量 设置泼得多猛、多少。
自动停止·停止前 经过设定的时间后停止。关闭后会持续流出,直到关闭规则或连接。
黏稠度 0 像水,1 像糖浆一样流动。
声音 默认「啪叽」会在首次命中时发出泼溅声,并伴有泼洒和流动的声音。选择其他声音时,倾倒期间会反复播放该声音;不选则无声。若默认「啪叽 · 随机」仍开启并加入其他声音,会随机播放其中之一,只想用自己的声音请关闭默认项。
外观与流动 颜色·发光·反射·表面张力等外观数值。无法运行流体的电脑会以简单水滴绘制。
湿润外观 液体碰到的地方显得湿润的外观和变干时间。对所有液体相同,默认 30 秒后变干。
贴纸

把自己的图片文件或文件夹(从中随机)、在线图片、动态 GIF·APNG·WebP 贴到角色上。选择观众头像时,会获取发送事件的观众的头像并贴上。

灯光
灯光动作的开关与持续时间
灯光动作的开关与持续时间

暂时把一盏灯打开·关闭·反转,或应用颜色·亮度、效果、预设。持续时间结束后会恢复为原来的灯光。持续时间最短为 1 秒。

冷却与按观众限制
项目 作用
冷却(秒) 运行一次后到下一次运行之间等待的时间。
按观众 只对同一观众的事件单独设置冷却。
删除此规则 删除条目。
在节点编辑器中打开… 在节点编辑器中打开此条目生成的图。

测试与排查问题

  • 点击 ▶,无需直播即可测试条目。
  • 对实际事件没有反应时,请依次确认平台连接、条目开关、冷却、最低金额。
  • 仍然不行时,请查看直播联动无法使用时,并发送错误报告。

倒下与起身

倒下与起身设置
倒下与起身设置

被重重击中或收到击倒动作时,角色会倒在地上,然后慢慢起身。在直播 → 互动 → 倒下与起身中设置。

设置 作用
倒下力度 倒下时向后推的力度。为 0 时会在原地直接倒下。
倒地时间 起身前躺在地上的时间。用节点击倒时,使用节点的等待时间。
起身时间 从地上起身回到原来姿势所需的时间。为 0 时立即起身。

无法倒下的角色在测试时会显示“此角色无法倒下”。

打赏显示

打赏框设置
打赏框设置

把打赏者的名字和留言以卡片形式显示在场景中的框里。默认关闭。

设置 作用
位置 像场景中的物体一样移动框并调整大小。
卡片 选择要显示徽章·昵称·留言·金额中的哪些。
事件 要显示的事件:CHZZK 打赏·Twitch 比特·订阅·频道积分。
堆叠 卡片数·显示时间·留言长度·最低金额。
按金额配色 按金额区间改变卡片颜色。
测试卡片 输入昵称·留言·金额,试着添加一张卡片。

节点编辑器

用连线连接节点,直接搭建“某个事件到来时,在某个条件下,做什么”。在简易设置不够用时使用。编辑和运行需要 Pro,Basic 中仅可查看、平移和缩放。它是直播联动功能,目前为测试版 (Beta)。

与简易设置有什么不同?

简易设置 节点编辑器
制作方法 在列表中选择触发和动作。 拖放节点并用连线连接。
能做的事 投掷·液体·贴纸·灯光·头像动作等固定反应 运算·变量·分支·循环,相机·灯光·表情·BlendShape·骨骼·键盘·鼠标·WebSocket 等约 400 种基本节点
适合的情况 一个事件对应一个反应 需要组合多个条件,或按顺序串联多个反应时

简易设置的条目在内部也以图运行。展开条目并点击在节点编辑器中打开…,即可查看该条目生成的图。

打开编辑器

  1. 打开直播 → 互动。
  2. 点击节点编辑器卡片的打开节点编辑器…。
  3. 编辑器窗口会在应用内打开。拖动标题可移动,拖动边缘可调整大小。用右上角的按钮放大查看或关闭。

关闭后图仍然保留并继续运行。

打开图列表和节点列表的节点编辑器
打开图列表和节点列表的节点编辑器
位置 作用
左上角书本图标 显示或隐藏图列表。
选择图 选择要编辑的图。用眼睛图标开启或关闭图。
右上角网格图标 显示或隐藏节点列表。
图列表下方的按钮 添加·删除·复制·重命名图、新建分组,以及 ⋯ 菜单(自动排列、导入·导出)。
节点列表 按分类排列的节点。用 Ctrl+K 搜索,用星标收藏。
小地图 在右下角查看整个图,点击即可跳到该位置。
撤销·重做 Ctrl+Z、Ctrl+Y

新图创建时处于关闭状态。完成后需用眼睛图标开启才会运行。

节点与连线

  • 从节点列表把节点拖到画布上即可添加。
  • 把节点右侧的点(输出)拖到另一个节点左侧的点(输入)即可连接。
  • 流程连线(绿线)表示运行顺序,从 EXIT 连到 ENTER。
  • 数值连线(灰线)传递金额·名称等数值。
  • 流程和数值不能互相连接。放到无法连接的位置时会显示原因。
  • 右键点击节点,会出现删除·复制副本·断开所有连线菜单。
  • 没有连线的输入,可以直接在节点内的输入框中填写数值。

示例:1 万韩元以上的打赏时泼水

CHZZK 打赏 → 整数比较 → 条件分支 → 喷洒液体的图
CHZZK 打赏 → 整数比较 → 条件分支 → 喷洒液体的图
  1. 用图列表的 + 新建一个图。
  2. 从节点列表的 CHZZK 分类中拖出 CHZZK 打赏。收到打赏时,流程从 EXIT 输出,并输出金额(韩元)。
  3. 从运算与文本分类中放置 整数:A ≥ B,把打赏节点的金额(韩元)连到 A。在 B 中填入 10000。
  4. 从流程控制分类中放置条件分支。把打赏节点的 EXIT 连到 ENTER,把比较节点的结果连到条件。
  5. 从互动分类中放置喷洒液体,把条件分支的为真时连到 ENTER。
  6. 用眼睛图标开启图。
  7. 在打赏节点的测试金额中填入 15000,点击测试,看看是否泼水。改为 5000 再测试,应该不会泼水。

所有事件节点都有测试栏和测试按钮,无需直播即可测试。图关闭时,测试也不会运行。

在节点编辑器中修改简易设置条目后

  • 该条目会显示为“已在节点编辑器中修改”,不再重新生成图。之后由图决定动作。
  • 点击条目菜单中的恢复为简易设置,会按条目设置重新生成图。在节点编辑器中修改的内容会丢失。
  • 自动生成的图中节点重叠时,请点击 ⋯ 菜单中的自动排列。

分享图

用 ⋯ 菜单的导出到剪贴板把图复制为文本,用从剪贴板导入·从文件导入…载入。导入的图处于关闭状态。别人给的图,请在确认内容后再开启。

测试

互动测试卡片
互动测试卡片

在直播 → 互动最下方的测试卡片中,无需规则或事件即可立即测试反应。每个按钮运行一次。

按钮 作用
投掷 按目标部位·力度·数量投掷物体。未选物体时,从库中随机选择。
击倒 让角色倒下。
击中 展示所选部位被击中的反应一次。开启投掷小物体后,物体也会飞来。
泼液体 设置量和方向(正面朝脸·从上方·从左侧·从右侧)后泼洒。
贴纸 随机贴上一张自己的图片。
还原 清除空中的物体·液体·贴纸,并让角色恢复原来的姿势。

Basic 与 Pro

功能 Basic Pro
查看直播页面 可以 可以
平台·Discord·WebSocket 连接 锁定 可以
简易设置·打赏显示·测试 锁定 可以
节点编辑器 仅查看·平移·缩放 编辑·运行

在 Basic 中,已保存的登录信息·规则·图也不会被删除,而是以锁定状态保留。

最后更新: 2026-10-24