我的收藏

更新记录

时间	更新内容
2024.9.3	创建文档

一、能力介绍

观众一键同玩能力旨在为观众提供更深度的玩法参与体验，帮助观众与主播建立更紧密的互动，为开发者带来更丰富的玩法设计空间和商业机会​

接入效果

【观众一键同玩能力】支持开发者指定观众云启动玩法，将玩法操作权发放给观众后，可以实现观众与主播同局玩的设计

•

开发者接入能力后，可获取直播间内正在连线的嘉宾信息列表

•

开发者可指定列表中的嘉宾云启动玩法，通过云启动参数控制嘉宾与主播加入同一场对局，让嘉宾获得玩法操作权

•

注：观众与主播连线后将成为直播间嘉宾，下文中的【嘉宾】皆指已连线的观众

适合玩法

•

接入【弹幕云启动】能力的玩法

•

同一场对局内有多个角色参与，角色需要用户控制，并在PC端和移动端完成操作适配的玩法

配置项	配置说明	示意图
接入【弹幕云启动】能力	1.【观众一键同玩能力】依赖云启动能力，开发者必须先接入【弹幕云启动】能力 2.【弹幕云启动】能力接入指引：弹幕云启动(原“玩法云启动能力”)_直播小玩法_抖音开放平台
能力申请	1.开发者可在小玩法后台【能力】-【互动数据】中找到【观众一键同玩能力】，点击【申请开通】后即可开通能力

接入方式

接口列表

接口名称	能力作用
获取直播信息	直播间信息中新增了玩法启动用户类型字段，开发者可用于判断用户身份，包含：主播、观众
查询直播间麦位信息	开发者查询观众上麦事件，可获取上麦嘉宾信息，包含： •当前嘉宾宿主是否支持云启动：支持、不支持 •嘉宾openid、头像、昵称 •嘉宾连麦状态：1-已在麦上；2-邀请上麦中 •嘉宾的麦位位置 •嘉宾麦克风状态
连麦用户云启动玩法	开发者可指定连麦嘉宾云启动玩法，需上报： •直播间roomid •玩法appid •云启动玩法的嘉宾openid •注意：观众一键同玩能力最多支持9人同局连线
连麦用户关闭玩法	开发者可指定连麦用户关闭玩法，需上报： •直播间roomid •玩法appid •关闭玩法的嘉宾openid
获取直播间礼物数据	直播间礼物数据接口中，新增被送礼对象audience_sec_open_id字段 •当观众向连线嘉宾送礼时，audience_sec_open_id将返回嘉宾openid •当观众向主播送礼时，audience_sec_open_id为空字符串
【可选】连麦用户玩法积分	开发者可上报连麦且加入对局嘉宾的积分，上报后将在麦位中展示

测试项	配置说明	示意图
直播间测试	1.上传调试包并开启云启动 ◦在小玩法后台【版本管理】-【调试包】中，上传包体并部署云游戏 ◦包体需接入【弹幕云启动】及【观众一键同玩能力】 2.主播侧测试 ◦抖音账号A在抖音内设为私密账号，并在小玩法后台添加为调试成员及开播测试账号 ◦直播伴侣：抖音账号A通过小扳手挂载调试包的本地包体 ◦抖音：抖音账号A在抖音内开播后，搜索对应玩法的调试包并挂载，调试包名称为：玩法名-调试包 3.观众侧测试 ◦抖音账号B在小玩法后台添加为调试成员 ◦进入抖音账号A的直播间并在直播间申请连线 ◦抖音账号A在玩法内邀请抖音账号B加入对局（玩法逻辑，开发者可自行设计） ◦抖音账号B将云启动调试包体，启动后加入抖音账号A所在的玩法房间或对局（玩法逻辑，开发者可自行设计）	•添加调试成员 •添加开播测试账号 •上传调试包

观众同玩玩法流程示意

主播在直播伴侣、抖音移动端都可开播，观众在直播伴侣、抖音移动端都可加入/云启动玩法

•

伴侣侧流程

•

抖音移动端流程

环节	设计说明	设计示意
告知观众连线玩法加入方式	需在玩法内的规则贴纸中，增加连线玩法加入方式的说明，如：点击直播间连线加入、与主播连线后加入	连线按钮设计素材（可下载使用）
玩法内展示连麦用户	建议开发者获取连麦用户信息后，在玩法内展示连麦用户列表，方便主播选择需要同局一起玩的用户
用户操作	如果玩法需要用户操作，建议开发者在玩法内设置虚拟摇杆、按钮，并做好PC端和移动端的适配	/