抖音开放平台Logo
开发者文档
控制台

玩法扩展组件能力

收藏
我的收藏

一、什么是玩法扩展组件

平台愿景:拓展全新的玩法场景,助力开发者在玩法内容深度与用户体验之间达成平衡,探索新的玩法商业模式。
    【内容深度】突破直播间公屏,为开发者的玩法创意提供更多的承载空间,为观众带来更持续、更优质的互动内容。
    【观众体验】增加玩法内容的同时,为观众提供更简单的交互方式,以降低因玩法内容增多而导致的观众理解和参与成本的上升。
    【场景打通】依托抖音小游戏的能力,为直播玩法构建更全面的流量入口,同时为厂商带来更多可探索的商业模式。

    1.用户体验

    扩展组件:本质是开发一款抖音小游戏应用,并且能够在【用户数据】及【展示场景】与直播玩法应用建立关联。
    小游戏本体:开发者可基于抖音小游戏的技术框架完成入驻、备案、开发、测试、上线等全流程。
    关联能力:支持开发者将具有同一公司主体的扩展组件与直播玩法关联,以完成用户数据、组件入口的关联。
    直播间跳转能力:支持开发者在扩展组件内展示主播直播间入口,用户可通过扩展组件进入玩法直播间。

    2.功能收益

通过严格 AA 对比,未使用过扩展组件的用户 VS 使用过扩展组件的用户,在玩法核心指标上的前后变化如下:
关键指标
数据变化
A 玩法看播表现
使用过扩展组件的用户,日均看播 UV 显著+60.5%
A 玩法参与表现
使用过扩展组件的用户,日均参与 UV 显著+66.7%
A 玩法付费表现
使用过扩展组件的用户,日均付费 UV 显著+67.3%

二、接入流程

    1.整体流程

                                                                                                                                                       整体接入流程 

    2.接入步骤

    1.【玩法扩展组件】的开发流程与小游戏一致,开发者可将其视作复用【抖音小游戏】能力所开发的一款小游戏。
    2.请参考以下步骤接入,红色字体内容需仔细阅读!
步骤
详细描述
示意图
    1.入驻小游戏平台
    2.注意:必须使用和直播玩法相同的公司主体进行入驻
    确保下图中,小游戏主体与小玩法主体一致
参考小游戏入驻流程
    2.创建小游戏并完善信息
    2.注意:
    小游戏名称需与小玩法一致或有相关性
    基础信息:描述内容必须为小游戏内实际内容,避免提及直播玩法
    小游戏类别:根据直播玩法的核心玩法内容填写小游戏类别
    小游戏无版号时,玩法扩展组件禁止接入内购、支付能力
参考小游戏上线运营流程
    3.申请小游戏备案
    2.预估 10-15 个工作日内完成市宣备案
参考小游戏备案流程
    4.申请 ICP 备案
    2.仅通过小游戏备案后,方可进行 ICP 备案,预估 20 个工作日内完成 ICP 备案
参考小游戏 ICP 备案流程
    5.开发小游戏
    2.注意
    无小游戏版号时,请勿接入抖音小游戏平台中的支付能力
    扩展组件可在直播场景中启动,建议开发者不在其中添加音乐、音效,避免与直播间声音冲突。
    6.接入小游戏必接能力
    2.注意:
    设计侧边栏入口和引导流程时,需对直播间拉起的半屏小游戏做好 UI 适配
    7.关联小游戏和直播玩法【必选】
    1.开发者需前往直播玩法后台,在能力 - 进阶互动能力中申请【玩法扩展组件能力】
    2.申请后,点击关联小游戏,选择对应小游戏关联即可
    注意:仅可关联和直播玩法公司主体相同的小游戏
    3.关联后:可接入下方第 8、9、10、11 中的相关能力
关联流程
    8.获取小游戏启动参数【必选】
    1.开发者可通过 getLaunchOptionsSync 方法获取启动参数
    2.当启动场景为小摇杆-扩展组件入口时,返回值extra字段中会新增以下字段:
    location = smallrocker_exp
    launch_from = live
    3.启动参数query中包含
    直播间 roomid
    主播 openid
    启动场景:小摇杆 - 扩展组件入口、其他小游戏启动场景
    4.指引:
    9.接入小游戏用户登录能力【必接】
    1.开发者通过tt.login接口获取到登录凭证后,可通过服务器发送请求的方式获取 session_key、小游戏openid、小玩法的 openid(即 binding_danmu_openid)
    10.接入直播间跳转能力【可选】
    1.开发者可通过 LiveManager.getLiveStatus 查询某个主播的 openid 是否在开播关联玩法
    2.关联玩法开播时,用户可跳转到对应直播间(LiveManager.navigateToLive)
    11.半屏场景 UI 适配【必接】
    1.开发者需通过屏幕宽高、x 分屏比例适配半屏、全屏时的小游戏 UI
    2.开发者可监听扩展组件半屏、全屏切换时的事件,进行UI重绘
    3.指引:
    12.小游戏版本提审
版本概览
    13.小游戏小玩法联调
    1.前置依赖
    开发者需准备 2 个抖音账号 A、B;
    抖音账号 A 作为主播挂载玩法,抖音账号 B 作为观众使用扩展组件;
    抖音账号 A、B 都需要设为玩法的调试成员,抖音账号 A 需设为私密账号。
    2.联调方法
    使用抖音账号 B 点击【小摇杆】-【玩法助手】入口,将默认拉起【测试通道】中最新上传的包体;
    若小游戏【测试通道】中未上传版本,点击入口后提示“暂无可调试的扩展组件”。
    14.小游戏发布
    2.注意:无版号时请勿接入内购能力,否则会导致扩展组件拒审
    15.性能优化

三、扩展组件设计要素

扩展组件小游戏必须按竖屏设计。

四、常见问题

    1.扩展组件和抖音小游戏什么关系?

扩展组件虽然是直播玩法的能力,但产物类型属于小游戏,开发者需通过抖音小游戏平台完成扩展组件的开发、上传和发布。

    2.扩展组件和小玩法的用户数据互通吗?

互通,请参考本文档 - 接入流程 - 接入步骤 - 第 9 步。

    3.扩展组件如何测试?

仅测试扩展组件时,可单独对小游戏包体进行测试,参考版本提审指引_小游戏_抖音开放平台
需和小玩法联调时,请参考本文档 - 接入流程 - 接入步骤 - 第 13 步。

    4.小游戏查询主播开播状态/跳转直播间能力