我的收藏

更新记录

时间	更新内容
2024.11.18	创建文档

一、能力介绍

开发者接入【同局主播连线能力】后，能够为同一场对局中的主播创建直播间语音连线，借此提升主播互动氛围和直播间效果，助力提升多主播同屏玩法的用户体验。

二、接入须知

版本要求：抖音版本需在 32.3.0 及以上，直播伴侣需要在 8.8.1及以上。

本能力仅允许【创新】类玩法接入，【经典】类玩法请勿接入，否则将会拒审。

接入本能力后时，请避免在【定向主播收益设置】中，对任意主播设置 ≤ 10%的分成比，否则将导致玩法在开播时无法连线。

三、接入指引

3.1 接入流程

3.2 能力接入

接入方式

接入方式	接入文档
OpenAPI接入	【技术接入文档】同局主播连线能力

接口列表

阶段	接口名称	接口描述
对局开始前	查询直播间麦位信息(可选)	1.接口作用：支持查询单个主播直播间麦位信息，以便后续主播选择让麦位嘉宾进入主主连线、开启嘉宾玩法 2.调用时机：建议在对局开始前拉取麦位信息，并邀请进入对局。
对局开始前	主播连线前置准备	1.接口作用：支持开发者提前判断目标主播是否能够参与连线，并进行前置准备 2.调用时机：在创建主播连线前，每个直播间均需调用一次
对局开始	创建主播连线	1.接口作用：建立最多 9 人的多主播直播间连线，并返回连线 ID 2.调用时机：建议在主播完成匹配后，至玩法开局前创建连线
对局进行中	查询主播连线麦位信息	1.接口作用：支持开发者依据连线 ID 查询连线麦位信息 2.调用时机：建议在创建主播连线后定时轮询，以感知中途嘉宾/主播上下麦。
	中途单主播离线(可选)	1.接口作用：支持单个主播离开所在的连线，同时该直播间的嘉宾会离线。 2.调用时机：建议主播在玩法内操作「离开对局」时调用
	附近语音(可选)	1.接口作用：实现连线主播间仅能听到特定用户声音的设计，支持控制用户能听到声源的音量，默认每个用户可听见所有在连线内的用户。 2.调用时机：开发者可根据玩法设计选择调用。如需调用，可在玩法开始时初始化音量控制，并依据玩法进程实时更新各主播的语音接收范围
	积分上报(可选)	1.接口作用：支持玩法上报连麦对局内用户积分，同步展示在直播间麦位上 2.调用时机：在对局开始、对局结束上报一次，对局期间定时上报
对局结束	结束主播连线	1.接口作用：解除多主播直播间连线 2.调用时机：建议在每局结束后，预留一段时间给主播交流、查看排行榜后，再结束连线

3.3 测试方法

步骤	示意
1.将主播A、主播 B 的抖音账号设置为调试成员 2.将主播 A、主播 B 的抖音账号设置为私密账号后，可在直播伴侣中挂载本地包体 3.主播 A、主播 B 在玩法内组队后，开发者可测试创建连线、结束连线、附近语音等功能点	/

四、连线玩法设计要素

4.1 整体流程

4.2 玩法示意

玩法环节	示意
主播匹配 1.玩法需要自建主播组队、匹配流程，为主播提供清晰易懂的交互流程 2.玩法当前需要自建匹配算法，后续平台将提供主播匹配开放能力，帮助厂商扩大主播匹配候选池，加快匹配时间	/
主播对局 1.玩法需设计主播同局匹配模式，支持多主播在同一局中游玩 2.主播在玩法内完成匹配时，开发者可调用同局主播连线接口，为主播们建立连线 3.主播在玩法内结束对局时，开发者可调用同局主播连线接口，为主播们结束连线 4.同局主播连线能力最大支持 9 个主播同时连线

FAQ

为什么无法为某些主播创建连线？

非公开直播间在创建连线时将被过滤，开发者可根据接口返回的过滤原因判断。