玩法扩展组件

我的收藏

一、什么是玩法扩展组件

平台愿景：拓展全新玩法场景，助力开发者平衡玩法深度与用户体验，探索新的商业机会
•【内容深度】：为玩法创意提供更多落地场景，为主播、观众提供更持续、更具品质的内容
•【观众体验】：在内容和互动上为观众提供更平衡的体验，避免玩法内容增加导致用户体验下降
•【场景打通】：依托抖音小游戏，为玩法构建更全面的流量入口，助力厂商探索新的商业模式 

用户体验

场景	路径	示意图
直播间场景	1.用户访问玩法直播间 2.点击小摇杆内的【玩法助手】 3.启动扩展组件
非直播间场景	1.用户通过抖音小游戏已有入口启动扩展组件，进而导流至玩法直播间 2.小游戏入口包括：抖音侧边栏、抖音搜索、抖音推荐流直出游戏等、......

•

扩展组件：本质是开发一款抖音小游戏应用，并且能够在【用户数据】及【展示场景】与直播玩法应用建立关联。

•

小游戏本体：开发者可基于抖音小游戏的技术框架完成入驻、备案、开发、测试、上线等全流程。

•

关联能力：支持开发者将具有同一公司主体的扩展组件与直播玩法关联，以完成用户数据、组件入口的关联。

•

直播间跳转能力：支持开发者在扩展组件内展示主播直播间入口，用户可通过扩展组件进入玩法直播间。

功能收益

类型	效果
提升玩法营收表现	通过严格 AA 对比，使用过扩展组件的用户相较于未使用过扩展组件的用户： •玩法日均看播 UV 显著+60.5% •玩法日均参与 UV 显著+66.7% •玩法日均付费 UV 显著+67.3%
探索抖音小游戏商业机会	扩展组件支持根据抖音小游戏规范接入广告组件、内购支付能力

二、【必看】接入流程

整体流程

接入步骤

1.【玩法扩展组件】的开发流程与小游戏一致，开发者可将其视作复用【抖音小游戏】能力所开发的一款小游戏
2.整体（开发+备案）预计耗时 30-50 天，请参考以下步骤接入，红色字体内容需仔细阅读！

步骤	详细描述	示意图
1.入驻小游戏平台	1.指引：注册与入驻_小游戏_抖音开放平台 2.注意：必须使用和直播玩法相同的公司主体进行入驻 ◦确保下图中，小游戏主体与小玩法主体一致	参考小游戏入驻流程
2.创建小游戏并完善信息	1.指引：创建与信息完善_小游戏_抖音开放平台 2.注意： ◦小游戏名称需与小玩法一致或有相关性 ◦基础信息：描述内容必须为小游戏内实际内容，避免提及直播玩法 ◦小游戏类别：根据直播玩法的核心玩法内容填写小游戏类别 ◦小游戏需提交软著，软著规范请参考小游戏资质规范 ◦小游戏无版号时，玩法扩展组件禁止接入内购、支付能力	参考小游戏上线运营流程
3.关联小游戏和直播玩法【必选】	1.开发者需前往直播玩法后台，在能力 - 进阶互动能力中申请【玩法扩展组件能力】 2.申请后，点击关联小游戏，选择对应小游戏关联即可 ◦注意：仅可关联和直播玩法公司主体相同的小游戏 3.关联后：可接入下方第 8、9、10、11 中的相关能力	关联流程
4.开发小游戏	1.指引：开发小游戏_抖音开放平台 2.注意 ◦扩展组件属于直播玩法场景的产物，请勿接入游戏群聊能力； ◦无小游戏版号时，请勿接入抖音小游戏平台中的支付能力； ◦扩展组件可在直播场景中启动，建议开发者不在其中添加音乐、音效，避免与直播间声音冲突。
5.接入小游戏必接能力	1.指引：必接能力_小游戏_抖音开放平台 2.注意： ◦开发者提交首个版本时必须接入【侧边栏复访能力】，否则可能会被拒审 ◦设计侧边栏入口和引导流程时，需对直播间拉起的半屏小游戏做好 UI 适配 ◦使用彩蛋页功能时扫测试版的二维码，勿使用IDE生成的二维码
6.开通小游戏流量主	1. 前往小游戏后台 - 商业化 - 流量主中申请开通即可，否则可能影响小游戏在 iOS 的可见性 2.开通后，开发者可根据优先级自行评估是否接入，指引：小游戏广告接入指引
7.申请小游戏备案	1.指引：小游戏备案申报_小游戏_抖音开放平台 2.预估 10-15 个工作日内完成市宣备案	参考小游戏备案流程
8.申请 ICP 备案	1.指引：ICP 备案指引_小游戏_抖音开放平台 2.仅通过小游戏备案后，方可进行 ICP 备案，预估 20 个工作日内完成 ICP 备案	参考小游戏 ICP 备案流程
9.接入小游戏必接能力	1.指引：必接能力_小游戏_抖音开放平台 2.注意： ◦开发者必须接入【侧边栏复访能力】 ◦设计侧边栏入口和引导流程时，需对直播间拉起的半屏小游戏做好 UI 适配 ◦使用彩蛋页功能时扫测试版的二维码，勿使用IDE生成的二维码
10.获取小游戏启动参数【必选】	1.开发者可通过 getLaunchOptionsSync 方法获取启动参数 2.当启动场景为小摇杆-扩展组件入口时，返回值extra字段中会新增以下字段： ◦location = smallrocker_exp ◦launch_from = live 3.同一直播玩法不同直播间支持复用扩展组件实例（抖音33.9.0支持），为了保证游戏内容和主播房间数据一致性，需要在游戏切前台监听中获取 launch_from、location 和 query，判断为扩展组件打开时，从 query 获取新的房间 roomid 和主播openid 后刷新游戏内容 4.启动参数query中包含 ◦直播间 roomid ◦主播 openid ◦启动场景：小摇杆 - 扩展组件入口、其他小游戏启动场景 5.指引： ◦JS API： ▪tt.getLaunchOptionsSync_小游戏_抖音开放平台 ▪tt.onShow_小游戏_抖音开放平台 ◦C# API： ▪获取小游戏启动参数_抖音开放平台 ▪游戏生命周期_小游戏_抖音开放平台
11.接入小游戏用户登录能力【必接】	1.开发者通过tt.login接口获取到登录凭证后，可通过服务器发送请求的方式获取 session_key、小游戏openid、小玩法的 openid（ binding_danmu_openid字段）
12.接入直播间跳转能力【可选】	1.开发者可通过 LiveManager.getLiveStatus 查询某个主播的 openid 是否在开播关联玩法 2.关联玩法开播时，用户可跳转到对应直播间（LiveManager.navigateToLive) 3.小游戏直播间 JS/C# API 指引：普通小游戏 & Unity小游戏
13.半屏场景 UI 适配【必接】	1.开发者需通过屏幕宽高、x 分屏比例适配半屏、全屏时的小游戏 UI ◦通过tt.getSystemInfoSync_小游戏_抖音开放平台获取安全区域safeArea，safeArea的width、height为半屏/全屏的宽高 2.开发者可监听扩展组件半屏、全屏切换时的事件，进行UI重绘 3.指引： jsapi：tt.getSystemInfoSync_小游戏_抖音开放平台 ◦c#api：获取系统信息_小游戏_抖音开放平台 ◦jsapi：普通小游戏 & Unity小游戏 LiveManager.onXScreenSizeChange
14.启动优化【必接】	1.Unity小游戏 ◦【必接】首包压缩：https://developer.open-douyin.com/docs/resource/zh-CN/mini-game/develop/guide/game-engine/rd-to-SCgame/unity-game-access/sc_build ◦【必接】资源预下载：https://developer.open-douyin.com/docs/resource/zh-CN/mini-game/develop/guide/performance-optimization/startup-performance/use-predownload-feature ◦优化指南：https://developer.open-douyin.com/docs/resource/zh-CN/mini-game/develop/guide/performance-optimization/startup-performance/sc_webgl_start_speed 2.Cocos/Laya/Egret小游戏 ◦【必接】资源预下载：https://developer.open-douyin.com/docs/resource/zh-CN/mini-game/develop/guide/performance-optimization/startup-performance/use-predownload-feature ◦优化指南：https://developer.open-douyin.com/docs/resource/zh-CN/mini-game/develop/guide/performance-optimization/startup-performance/boost-game-speed
15.小游戏版本提审	1.指引：版本提审指引_小游戏_抖音开放平台	版本概览
16.小游戏小玩法联调	1.前置依赖 ◦添加直播玩法调试成员 ▪开发者需准备 2 个抖音账号 A、B； ▪抖音账号 A 作为主播挂载玩法，抖音账号 B 作为观众使用扩展组件； ▪抖音账号 A、B 都需要设为玩法的调试成员，抖音账号 A 需设为私密账号。 ◦添加小游戏测试版本可见性名单 ▪请到抖音开放平台-控制台-我的应用「小游戏tab」-右下角「开发者助手」-「在线客服」联系客服加白处理 2.联调方法 ◦使用抖音账号 B 点击【小摇杆】-【玩法助手】入口，将默认拉起【测试通道】中最新上传的包体； ◦若小游戏【测试通道】中未上传版本，点击入口后提示“暂无可调试的扩展组件”。
17.小游戏发布	1.指引：发布小游戏_小游戏_抖音开放平台 2.注意：无版号时请勿接入内购能力，否则会导致扩展组件拒审
18.性能优化	1.指引：性能优化_小游戏_抖音开放平台