《Toy开发者FAQ》—— 有Toy相关问题?先看这篇答疑帖!(更新至2026.10.16)
哔哩哔哩Toy
编辑于 2026年10月19日 20:46
哔哩哔哩Toy创意挑战

大家好,本帖整理了Toy开发者的常见提问与解答,各位Toy开发者可根据目录快速查阅!

如有其他问题,欢迎在评论区留言,或前往Toy开发者小站​发帖,我们会定期补充本篇答疑。

一、发布与审核

1. Toy审核需要多久?

正常情况下,审核在10分钟内完成。只要Toy本身内容合规,无需担心审核时长。若有异常迟迟未过审,可联系平台工作人员协助排查。

2. 小站发帖需要审核吗?审核多久?

需要,有一定审核时间,通常较快。若未通过审核,多数是因为内容不合规(如涉及引导至站外注册等)。

3. 发布后Toy不见了或打不开怎么办?

可能是您使用的访问路径(slug)与历史已有条目重复,建议重新发布并更换一个slug。

4. 一个账号可以发布多个Toy吗?

可以,目前没有数量限制。

5. Toy支持哪几种可见状态?

支持“所有人可见”“链接访问”“密码访问”三种状态,可在管理后台互相转换。详情可见>>Toy发布后怎么被看见​

5.1 所有人可见:选择该发布方式时,系统会使用当前上传Toy的账号自动发布一条公开动态,可在右侧预览页查看该动态展示;该链接可在Toy及相关动态可被搜索、推荐和分享。

5.2 链接访问:该发布方式可用于在开发者可知可控的范围内测试Toy链接。仅持有链接的人可以访问Toy和关联动态,该动态不会自动在首页、动态、个人主页、搜索等出现。

5.3 密码访问:系统生成访问密码。仅持有密码的人可以访问Toy和关联动态,该动态将隐藏封面和完整标题。

5.4 链接访问、密码访问、所有人可见支持互相转换啦!已经发布的 Toy 在更新时选择新的发布方式即可修改~

Toy从【链接访问】、【密码访问】 转【所有人可见】后,发布Toy时关联的那条动态会从隐藏变为公开,动态可以在首页、搜索、个人主页等被所有人看到;

相反,当Toy从【所有人可见】转【链接访问】、【密码访问】后,则该动态也会在所有场景隐藏,此时仅获得该Toy链接的人可以继续访问。

6. Toy最大支持多大的文件包?

文件包上限为 50MB,更大包体需在【创作者设置】中单独申请。

7. 发布后还能修改文件吗?

支持无限次修改文件并更新网页内容,可在“发布记录”-“更新”中进行修改、更新操作。

8. 能自定义Toy的访问路径吗?

支持自定义访问路径(slug),可在“上传发布”-“页面地址”手动输入调整访问路径。

9. 视频和Toy想同时上线,担心Toy卡审核?

审核流程稳定,无需过度担心。如果确实遇到卡审,可及时联系平台工作人员。也可先以“链接可见”方式发布,通过审核确认内容无误后再转为公开

建议将多次修改攒在一起统一更新,减少审核次数;若仍频繁卡审,可联系平台工作人员做特殊处理。

10. 发布Toy有门槛吗?需要先提交创意等待审核吗?

进入发布页面即可发布Toy,无需事先提交创意等待审核。若账号尚未获得Toy权限,须先通过权限申请。

11. 分类Tag与作品图标可以自定义吗?

发布平台已支持分类Tag(工具、攻略、游戏等)与自定义作品图标。系统自动分类可能存在偏差,可在发布平台自行修改;作品图标支持自行上传。

12. Toy 的发布入口在哪里?如何申请内测资格?

PC 端创作中心侧边栏已新增 Toy 入口,符合条件的创作者可一键直达发布平台。

尚未获得资格的,请点击下方链接申请内测。

>>Toy权限唯一申请入口​<<

13. Toy 能限制未成年人游玩吗?

可以。类型设置为「游戏」后,未成年人将自动无法游玩;未成年开发者在测试阶段可先不选「游戏」分类,以便正常上传与测试。

14. 新建 Toy 的封面 / 图标上传后看不到?

新建 Toy 的封面与图标同样需要审核,审核期间可能不显示,过审后会正常展示。

15. Toy 入口文件 index.html 有大小限制吗?

平台对入口文件 index.html 开启 1MB 大小限制。建议提前优化 index.html,把较大的脚本、样式和内嵌图片拆成独立文件引用。

16. 用 Mac 自带浏览器(Safari)提交 / 发布 Toy 有异常?

用 Mac 自带浏览器上传文件后会跳到预览页、无法直接发布,建议改用 Chrome。

二、视频与Toy联动

1. Toy发布时可以绑定视频吗?

可以,仅支持绑定本人发布的视频。可在“发布记录”-“管理”-“视频绑定”中操作绑定视频。

2. 一个Toy可以绑定多个视频吗?一个视频可以绑定多个Toy吗?

一个Toy可绑定多个视频,但一个视频只能绑定一个Toy。

3. 绑定视频有什么作用?

绑定后,Toy会出现在视频下方的入口位置,便于观众直接体验。

4. 不绑定视频的话,Toy能获取到视频流量吗?

绑定视频是获取视频流量的前提条件,建议同时绑定视频+简介/评论区挂链接。

5. 怎么与哔哩哔哩Toy官方账号进行联合投稿?

视频发布后可联系平台运营人员评估沟通。

需 UP 主权益等级 ≥4 级且粉丝数达一千后解锁联合投稿,联合投稿需稿件达到 10000+ 播放后评估;视频投稿时必须带tag:bilibilitoy,并带话题:哔哩哔哩Toy创意挑战,分区不限制。

6. Toy 内如何显示 B 站视频(如过场动画)?

可使用 bilibili 播放器 iframe,详见player.bilibili.com​

7. 竖屏视频对Toy推广有帮助吗?

有帮助。推荐采用「一条横屏 + 多条竖屏爽点切片 + 图文」的组合投放方式。部分Toy的流量中,竖屏短视频来源占比可达 37%–50%。

8. 能否把战绩截图分享到B站动态?

目前可将Toy入口以二维码形式放入分享内容。

9. Toy内能否生成并下载视频?

目前仅图片类型支持保存到本地。

三、SDK功能

1. Toy SDK支持哪些功能?

详情见发布平台顶部的【SDK和CLI】,当前主要支持:

  • 云存档、排行榜

  • 关注检测、三连判断(投币/点赞/收藏)

  • 获取用户昵称、头像

  •  检查用户是否包月充电

  •  二维码 / 保存图片页 / 网页跳转

  •  摄像头/麦克风采集、控制横竖屏与沉浸模式

2. 如何判断用户是否三连(投币/点赞/收藏)?

可使用 toy_getuservideoaction 这个SDK。

3. 如何获取用户的昵称和头像?

通过SDK对应接口获取即可,需要用户信息时SDK会自动调用。

4. 排行榜能否增加扩展字段?

如有具体需求,建议向运营提交需求说明文档,以便平台方充分理解并进行评估。

5. SDK会开放评论区功能吗?

目前手机端Toy页面下方已支持评论互动。

6. SDK文档在哪里查看?

请访问官方链接:SDK文档​;(需登录有 Toy 权限的账号才能查看)

7. 如何控制设备横竖屏、沉浸全屏?

Toy JS SDK 已新增容器状态能力:可读取/监听设备类型、可用尺寸、横竖屏、沉浸状态和安全区,也支持通过 setContainerMode 切换横竖屏与沉浸模式,适合横屏游戏、沉浸式互动页。

需 B站 App 升级到 9.9.0 及以上。示例:设备横竖屏、沉浸全屏示例​

8. 如何获取录音权限?

请查看 SDK 文档中的录音部分(需登录有 Toy 权限的账号)。Demo 参考:录音权限示例​。

9. 能否指定调用超广角摄像头?

目前不支持广角摄像头。

10. 能否获取用户位置?

获取用户位置的 API 尚未开放。

11. Toy 本地存储数据容易丢失怎么办?

本地存储易被用户清缓存或手机清理而丢失;建议重要数据优先使用云存档。

云存档本身支持多端同步;若发现手机与电脑数据不一致,先确认测试时已授权登录B站账号。

12. 排行榜、云存档接口有频率限制吗?

排行榜与云存档接口对单个Toy限流约 50 QPS,大批量新用户进入时可能触发。建议使用本地缓存配合定期保存,避免实时写入;拉取过程建议设计「加载中」状态,不要默认拉取瞬时完成。

13. 排行榜数值有上限吗?

排行榜存在最大数值限制,跨平台展示场景下 Float32 的适配性最好。如确有需要,可在本地对上传值与展示值做偏移处理;排行榜SDK不参与数值展示。

14. 沉浸模式下能获取顶栏(胶囊)的坐标与尺寸吗?

可以获取,具体位置参数由SDK提供,建议避开安全区放置交互元素。

15. 如何实现「充电畅玩」或获取作者全部Toy?

可基于已有的充电相关SDK,配合自建索引Toy实现。

16 是否支持「添加到桌面」?

已支持。可在Toy内引导用户添加至桌面,请注意识别用户所处环境(不同端能力存在差异)。

17. 在上传成绩处设置「必须关注」是否推荐?

不推荐在主线链路上强制设置关注,会明显影响用户体验。建议在复活、强化、获取新武器等环节加入关注引导。

如需实现「关注后解锁」,可使用 SDK 的关注检测能力;但 Toy 内须保留无需交互即可见的内容(见「内容规范与合规」)。

18. 是否支持陀螺仪等传感器能力?

陀螺仪已在计划中,暂未排期。

19. 排行榜如何存储数字以外的多种数据?

当前支持 5 个排行榜,可用多个排行榜分别存储、最后合并展示。

20. 移除榜单中的用户会影响其他榜单吗?

会。目前移除用户会同时移除其所有榜单记录,暂不支持只清空单个榜单。

21. 不同 Toy 之间可以共享存档吗?

可以。同一用户的存档现可在多个 Toy 之间延续,不同玩家的存档仍各自独立。具体接入方式可参考:Toy SDK​

四、内容规范与合规(重要!)

1. Toy涉及版权问题怎么办?

需保证所有素材版权合规,可参考视频和图文的版权处理标准。不同版权方对二次创作的限制不同,具体情况需作者自行判断。若版权方发起侵权投诉,平台将依法依规处理。

2. Toy里可以让用户自建昵称和头像吗?

不可以。为避免内容安全风险,昵称和头像应使用SDK获取的用户信息或由系统随机生成,不允许用户自行创建。可提供预置候选昵称供用户选择。

3. 如果Toy中包含自由输入框,需要注意什么?

需自行接入内容安全审核机制,防止被恶意输入违禁内容。

4. Toy禁止事项举例,最终以用户协议为准>>Toy用户协议​

  • 不得放置广告

  • 不得跳转站外链接

  • 不得侵犯他人版权

  • 不得允许用户自建昵称/头像(需使用SDK或系统随机)

  • 自由输入内容需自行接入内容安全审核

  • 不得以锁死基础功能为条件提供附加体验,基础功能应保持可用

  • 不得出现第三方平台登录/跳转

  • 不得常驻式引导干扰体验

5. 关于 UGC 的安全红线

用户可自定义上传内容(UGC,如上传文字/图片/拍照、聊天室、画板等)属安全红线,平台正向「权限点审核」收敛,代码层面直接禁止未经授权的 UGC 能力。对于已接入内容安全审核的文本输入、且不允许用户上传底图的场景,仍需以平台审核结论为准。

6. 名称、封面、标题、图标的合规要求

请遵守内容安全底线,不涉政、不涉黄,不得侵权,不允许使用他人商标的。

7. 模拟特定机构/App 界面的 Toy(如模拟银行)有风险吗?

请在显著位置明确标识「这并非真实银行 App 界面」等提示,避免误导用户,否则存在合规风险。

8. 游戏BGM、音效可以使用网络热门音乐吗?

需保证版权合规。建议使用无版权或已获授权的素材,避免直接使用商用曲库内容。若版权方发起投诉,平台将依法依规处理。

9. 跟热点创作需要注意什么?

跟热点可行,但须注意措辞与内容,不得涉黄涉政,不得违反社区公约及相关法律法规。

10. 引用外部资源有哪些合规限制?

外部资源目前尚未禁止,但相关权限将逐步收敛,建议尽量减少对第三方资源的依赖;同时绝对禁止提供UGC能力(如聊天室、用户自由输入文字等),以内嵌框架实现聊天室同样不被允许。

11. 可以在 Toy 内接入第三方平台登录吗(如 QQ、TapTap)?

不可以。Toy 默认自动登录 B站账号,禁止出现其他第三方平台的登录或跳转。

12. 可以引导用户前往站外(如爱发电)吗?

不可以。Toy 内不得提供爱发电、微信 / 支付宝收款码等第三方收款方式,违规会被限流或下线;如需引导充电,请引导用户到作者的B站个人主页进行。

13. 可以使用 b23 短链吗?

不建议。b23 短链约一年后失效,到期会导致 Toy 打不开。

14. Toy 内可以做问卷调查吗?

可以,但需自建后端,且不得收集用户个人敏感信息。

15. 可以在 Toy 内展示赞助名单吗?

可以,自行实现即可,合规要求与在视频中感谢充电粉丝一致。

16. Toy 内必须保留免交互即可见的内容吗?

是的。Toy 内必须有一个用户不进行任何交互(关注、点赞等)也能看到的内容,不能所有内容都需关注或互动才能解锁。例如Toy 内至少有 1 个用户可以免费获取的内容 / 资料。

五、数据与统计

1. 浏览量怎么统计的?

在B站App内具备登录态的用户访问才会计入浏览量。

2. 单款Toy数据在哪里查看?

Toy详情页顶部即可查看相关数据。

3. Toy怎样才能被收录进【哔哩哔哩玩具铺】推荐页面?

浏览量超过500后会被收录,每周一更新。数据统计截止至前一天24点,具体更新时间在当天内。

4.  “Toy 广场”双端上线啦!

全新 Toy 广场已上线:在任意 Toy 详情页点击右上角广场图标即可进入,公开 Toy 将获得新的展示与曝光入口,并支持站内搜索。

>>Toy 广场入口​<<

广场目前只收录「公开可见」的 Toy;仅链接可见的需先改为公开可见才能进入广场获得曝光。

Toy 广场

5. 怎样被收录进 Toy 广场 / 入选「本周必玩」?

  • 广场收录:选择「公开发布」即可被收录进 Toy 广场,无体验量限制。

  • 「本周必玩」每周一晚更新,可在 App / Web 端搜索「Toy」进入 Toy 广场查看。

  • 「本周必玩」收录规则:运营综合Toy当周体验量、互动数量、内容质量精选 6–10 个Toy发布,分为「娱乐」「工具」两条赛道(工具赛道相对不拥挤)。

  • 提升入选概率:可参照Toy运营白皮书进行运营>>Toy运营白皮书​

6. 留存数据在哪里查看?

发布平台数据看板已新增「次日留存率」,单 Toy 明细与统计页均可查看。

7. 「今日推荐」是如何产生的?

系统自动推荐,游玩量高的作品会自动上榜,非人工操作,也不受其他因素干预。

8. 电脑端可以查看 Toy 的作品排名吗?

可以。在 Toy 广场的「我创作的」中,可以查看自己 Toy 的全站 PV 排名。

9. Toy 的访问量看起来异常怎么办?

平台已对识别出的异常访问数据做了修正,后续会加大风控和数据巡检力度。开发者也可对关键数值做服务端校验,避免被刷。

六、推流与推广

1. Toy推流多久会有?

推流时长不固定,视频封面点击率越高,系统会给予更长的自动推流时间。一般提交推流申请后一天内即可推流,系统会显示「已推」并下发 B站私信通知。

2. 推流申请表怎么填?

填写时请按官方推流申请表格的要求,并带上指定的tag和话题。推流表格反馈一般在 24 小时内。

3. 新游曝光难怎么办?

新游曝光是普遍难题,建议蹭热门标签、持续维护Toy活跃度、经常发视频、拉玩家群,推流效果也受首日数据影响;可参照Toy运营白皮书进行运营>>Toy运营白皮书​

七、技术问题

1. 哪些文件能直接上传到Toy?

出于安全考虑,只有白名单内后缀的文件会被发布,其余文件(如可执行文件、后端脚本)会被自动过滤掉。平台支持哪些格式的文件,请查看Toy发布常见问题​

2. Toy支持数据共享或创意工坊吗?

目前暂不支持跨用户KV存储,该功能已在未来规划中。

3. Toy支持联机功能吗?

联机功能需开发者自建后端服务,并利用云存档减轻服务器压力。

4. Toy的URL打不开怎么办?

请检查URL是否完整,注意不要遗漏 index.html 后缀。

5. 构建产物要放在ZIP根目录吗?

需要,确保压缩包根目录包含 index.html 文件,否则页面无法正常加载。

6. 有没有测试环境?

可直接使用正式环境,发布时选择“链接可见”或“密码可见”模式,再用小号进行测试即可。

7. 能引用外部资源吗?能用 WebGPU 吗?

可以引用外部资源;WebGPU 取决于 B站 App WebView 及系统/GPU/驱动是否支持(系统不支持则无法使用),建议用 WebGL/WebGL2 兜底,并在真机容器中测试。

8. 预览与正式环境表现不一致?

预览是生效的,但预览页与真实环境格式可能略有差异;若遇到「预览正常但发布后打不开」等具体问题,请携带复现信息反馈官方排查。

9. 沉浸模式下按键被安全区遮挡/挤压怎么办?

建议不要在安全区(尤其顶部区域)放置交互元素;顶栏高度 SDK 有返回,整体避开即可。沉浸模式不影响按键位置,布局优化可借助 AI Agent 协助(如将设置收进二级菜单)。

10. Toy 能不能内嵌外部网页(iframe)?

Toy 不能通过 iframe 外链其他网页。

11. 推荐技术选型

ThreeJS、Unity、Canvas 2D 等前端技术均可正常使用;Godot 对 Web 兼容性一般(3.x 尚可、4.x 后有较大变化且需全量下载),更适合单机,Web 向推荐前两者。

12. 多机型按键适配怎么做?

不同机型(安卓/苹果/平板)按键适配是公认难题,可在设置中允许玩家自行调节按键位置。

13. 排行榜刷分与反作弊怎么处理?

  • 若被恶意刷分,可直接在管理端拉黑该账号封禁。官方已记录「允许开发者在排行榜上传成绩时自定义轻量 JS 校验」的方案,并在持续跟进反作弊通用能力。纯 B站排行榜难以彻底解决反作弊;核心思路是「每局后端运算结果」,而非依赖前端上报。

  • 可用排行榜 Challenge 机制做弱版鉴权(用户须先通过公开排行榜完成挑战、关联 B站账号),再配合后端验签。

  • 注意:查询充值/关注等前端校验均可能被破解,相关内容宜作为附加玩法或精神奖励,而非硬性门槛。

14. Unity 打包上传后黑屏怎么办?

常见原因是包体默认开启了压缩,或包含 .mp4 视频文件。可尝试关闭压缩、移除视频文件或改为通过 CDN 加载后重新上传。

15. Cocos 引擎部分编译文件被平台过滤怎么办?

Cocos 引擎的 .cconb.bin 等文件会被打包流程过滤,使用前请确认脚本来源与安全性。

16. Toy 可以使用后端服务或调用自有 API 吗?

可以。平台并非仅支持纯前端,SDK 提供云存储与排行榜读写能力;自建后端服务、调用自有 API 需先开通相应权限,可在发布平台查询账号权限状态,未开通需走申请流程。

17. 跳转与外链的判定标准是什么?

SDK 提供跳转能力:跳转自己的B站主页可以,跳转站外不允许,尺度与个人主页、视频简介保持一致;wiki.biligame.com​ 等可蓝链的站内域名不属于站外。

18. 旧版本客户端无法横屏怎么办?

一是客户端版本过低,需升级至支持版本;二是建议做旋转自适应处理,旧版本用户在开启自适应后自行旋转屏幕即可横屏。

19. 会提供预发布或调试环境吗?

平台计划推出「调试版本」:免审、仅作者本人可见。现阶段建议使用两个Toy区分测试版与正式版,直接在正式环境中测试。

20. 如何做多 Toy 串联的关卡游戏 / 共享进度?

可通过 Toy 间跳转串联;「同用户不同 Toy 共享 KV」的开放能力正在开发中,跨用户共享 KV 也在规划中,现阶段可先在本地自行实现。

21. Toy 的代码会被盗用吗?如何保护核心逻辑?

Toy 是前端网页,纯前端逻辑较容易被还原;建议把核心逻辑放到自建后端,并配合鉴权(如校验 B站用户身份)与官方 SDK,抬高对方盗用的成本。

22. 如何做多 Toy 串联的关卡游戏 / 共享进度?

可通过 Toy 间跳转串联;「同用户不同 Toy 共享 KV」已开放,可在发布平台「共享存档」创建存档标识,并授权合作作者使用(详见「三、SDK功能」——不同 Toy 之间可以共享存档吗?)。

23. 全屏横屏后页面变得很小、偶尔才恢复正常,怎么办?

可在 onContainerChange 里消费 viewport 变化并调用 game.scale.refresh()(配合延时重试兜底),即可恢复正常缩放。

八、B站App内体验

1. 在App里怎么找到玩过的Toy?

目前平台正在规划更多查找路径。开发者可将相关动态置顶方便粉丝访问,也可建议粉丝收藏。

手机端公开 Toy 目前主要在动态里找,非公开的去发布页面找;PC 端可通过投稿中心-图文管理查看(含加密/隐藏动态)。

2. 桌面快捷方式有开屏广告怎么办?

该问题为系统层面行为,可留意后续优化。iOS 上若默认浏览器非 Safari,添加到桌面可能直接打不开;官方已针对 Safari 做适配,其他浏览器缺失测试,已记录。

3. 鸿蒙版 B站 支持 Toy 吗?

鸿蒙版 B站更新后已支持用户进入和使用 Toy,但暂不支持点赞、评论等互动功能,请开发者关注鸿蒙用户的使用情况。

4. 国际版/海外版 B站 支持 Toy 吗?

支持,但功能完备程度低于国内主站,具体表现以实际版本为准。

5. 沉浸模式下评论栏会隐藏吗?

沉浸模式下评论栏默认隐藏。

6. 电脑浏览器上可以使用 Toy 吗?支持哪些互动?

可以。现在用电脑浏览器使用 Toy,也能和 UP 主互动:支持点赞、评论、快捷关注 UP 主,还可以进入 Toy 广场发现更多作品。

九、运营与支持

1. 官方工作时间是几点?

工作人员会不定期查看消息,如有问题可随时留言,看到后会及时回复。

2. 遇到问题去哪里提问?

欢迎前往Toy开发者小站发帖交流:Toy开发者小站​

3. “建议配合Agent使用”是什么意思?

指将Toy开发文档和SDK文档配置给AI编程助手,以辅助开发和调试。

4. 权限申请多久处理一次?

权限申请于每周二、周四集中处理。已具备Toy权限的账号,登录后能正常进入发布页即可发布。

5. 被下架或审核不通过,如何查询原因?

审核相关问题请查看内测群公告中的审核咨询入口,由专门审核人员对接;也可先自查是否存在用户自由输入、外链或不合规资源。

6. 自己的 Toy 相关视频被搬运 / 侵权了怎么办?

可在视频详情页提交侵权投诉,平台有对应流程处理。

十、收益与商业化

1. Toy有收益吗?

Toy本身不直接产生收益,但优质内容带来的流量可间接为关联视频增加曝光,从而辅助视频收益。第三方广告不可行!

已知部分案例为「商单+视频」组合变现,主要取决于账号自身影响力。建议将Toy视为视频之外的一种内容表达形态。

2. Toy能挂广告联盟的SDK吗?

暂不支持。

3. Toy支持付费功能吗?

不支持支付功能,但可通过SDK检查用户是否包月充电,用于定制化体验。

充电查询目前仅限包月充电信息(非实时扣款),且为前端校验、可能被破解,建议用于额外玩法或精神奖励类内容。

4. Toy在其他平台发布过 / 需不需要独家?

创作版权属于作者,Toy 发布不影响在其他平台发布;但其他平台已发布内容能否再发 Toy,以该平台用户协议为准。Toy 不要求独家。

5. Toy 能接入 B站小店 / 带货吗?

相关能力目前仍在开发中,暂未开放。此外,Toy 及其源码可作为资产在 B站小店售卖,代码资产归作者本人所有。


如有其他疑问,欢迎在评论区留言,或在Toy开发者小站发帖,我们会持续关注并完善本FAQ。祝各位开发顺利!