大家好,本帖整理了Toy开发者的常见提问与解答,各位Toy开发者可根据目录快速查阅!
如有其他问题,欢迎在评论区留言,或前往Toy开发者小站发帖,我们会定期补充本篇答疑。
正常情况下,审核在10分钟内完成。只要Toy本身内容合规,无需担心审核时长。若有异常迟迟未过审,可联系平台工作人员协助排查。
需要,有一定审核时间,通常较快。若未通过审核,多数是因为内容不合规(如涉及引导至站外注册等)。
可能是您使用的访问路径(slug)与历史已有条目重复,建议重新发布并更换一个slug。

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

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

5.2 链接访问:该发布方式可用于在开发者可知可控的范围内测试Toy链接。仅持有链接的人可以访问Toy和关联动态,该动态不会自动在首页、动态、个人主页、搜索等出现。
5.3 密码访问:系统生成访问密码。仅持有密码的人可以访问Toy和关联动态,该动态将隐藏封面和完整标题。
5.4 链接访问、密码访问、所有人可见支持互相转换啦!已经发布的 Toy 在更新时选择新的发布方式即可修改~
Toy从【链接访问】、【密码访问】 转【所有人可见】后,发布Toy时关联的那条动态会从隐藏变为公开,动态可以在首页、搜索、个人主页等被所有人看到;
相反,当Toy从【所有人可见】转【链接访问】、【密码访问】后,则该动态也会在所有场景隐藏,此时仅获得该Toy链接的人可以继续访问。
文件包上限为 50MB,更大包体需在【创作者设置】中单独申请。

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

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

审核流程稳定,无需过度担心。如果确实遇到卡审,可及时联系平台工作人员。也可先以“链接可见”方式发布,通过审核确认内容无误后再转为公开
建议将多次修改攒在一起统一更新,减少审核次数;若仍频繁卡审,可联系平台工作人员做特殊处理。
进入发布页面即可发布Toy,无需事先提交创意等待审核。若账号尚未获得Toy权限,须先通过权限申请。
发布平台已支持分类Tag(工具、攻略、游戏等)与自定义作品图标。系统自动分类可能存在偏差,可在发布平台自行修改;作品图标支持自行上传。
PC 端创作中心侧边栏已新增 Toy 入口,符合条件的创作者可一键直达发布平台。

尚未获得资格的,请点击下方链接申请内测。
>>Toy权限唯一申请入口<<
可以。类型设置为「游戏」后,未成年人将自动无法游玩;未成年开发者在测试阶段可先不选「游戏」分类,以便正常上传与测试。
新建 Toy 的封面与图标同样需要审核,审核期间可能不显示,过审后会正常展示。
平台对入口文件 index.html 开启 1MB 大小限制。建议提前优化 index.html,把较大的脚本、样式和内嵌图片拆成独立文件引用。
16. 用 Mac 自带浏览器(Safari)提交 / 发布 Toy 有异常?
用 Mac 自带浏览器上传文件后会跳到预览页、无法直接发布,建议改用 Chrome。
二、视频与Toy联动
可以,仅支持绑定本人发布的视频。可在“发布记录”-“管理”-“视频绑定”中操作绑定视频。


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

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

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


视频发布后可联系平台运营人员评估沟通。
需 UP 主权益等级 ≥4 级且粉丝数达一千后解锁联合投稿,联合投稿需稿件达到 10000+ 播放后评估;视频投稿时必须带tag:bilibilitoy,并带话题:哔哩哔哩Toy创意挑战,分区不限制。
可使用 bilibili 播放器 iframe,详见player.bilibili.com
有帮助。推荐采用「一条横屏 + 多条竖屏爽点切片 + 图文」的组合投放方式。部分Toy的流量中,竖屏短视频来源占比可达 37%–50%。
目前可将Toy入口以二维码形式放入分享内容。
目前仅图片类型支持保存到本地。

详情见发布平台顶部的【SDK和CLI】,当前主要支持:
云存档、排行榜
关注检测、三连判断(投币/点赞/收藏)
获取用户昵称、头像
检查用户是否包月充电
二维码 / 保存图片页 / 网页跳转
摄像头/麦克风采集、控制横竖屏与沉浸模式
可使用 toy_getuservideoaction 这个SDK。
通过SDK对应接口获取即可,需要用户信息时SDK会自动调用。
如有具体需求,建议向运营提交需求说明文档,以便平台方充分理解并进行评估。
目前手机端Toy页面下方已支持评论互动。
请访问官方链接:SDK文档;(需登录有 Toy 权限的账号才能查看)
Toy JS SDK 已新增容器状态能力:可读取/监听设备类型、可用尺寸、横竖屏、沉浸状态和安全区,也支持通过 setContainerMode 切换横竖屏与沉浸模式,适合横屏游戏、沉浸式互动页。
需 B站 App 升级到 9.9.0 及以上。示例:设备横竖屏、沉浸全屏示例
请查看 SDK 文档中的录音部分(需登录有 Toy 权限的账号)。Demo 参考:录音权限示例。
目前不支持广角摄像头。
获取用户位置的 API 尚未开放。
本地存储易被用户清缓存或手机清理而丢失;建议重要数据优先使用云存档。
云存档本身支持多端同步;若发现手机与电脑数据不一致,先确认测试时已授权登录B站账号。
排行榜与云存档接口对单个Toy限流约 50 QPS,大批量新用户进入时可能触发。建议使用本地缓存配合定期保存,避免实时写入;拉取过程建议设计「加载中」状态,不要默认拉取瞬时完成。
排行榜存在最大数值限制,跨平台展示场景下 Float32 的适配性最好。如确有需要,可在本地对上传值与展示值做偏移处理;排行榜SDK不参与数值展示。
可以获取,具体位置参数由SDK提供,建议避开安全区放置交互元素。
可基于已有的充电相关SDK,配合自建索引Toy实现。
已支持。可在Toy内引导用户添加至桌面,请注意识别用户所处环境(不同端能力存在差异)。
不推荐在主线链路上强制设置关注,会明显影响用户体验。建议在复活、强化、获取新武器等环节加入关注引导。
如需实现「关注后解锁」,可使用 SDK 的关注检测能力;但 Toy 内须保留无需交互即可见的内容(见「内容规范与合规」)。
陀螺仪已在计划中,暂未排期。
当前支持 5 个排行榜,可用多个排行榜分别存储、最后合并展示。
会。目前移除用户会同时移除其所有榜单记录,暂不支持只清空单个榜单。
可以。同一用户的存档现可在多个 Toy 之间延续,不同玩家的存档仍各自独立。具体接入方式可参考:Toy SDK
需保证所有素材版权合规,可参考视频和图文的版权处理标准。不同版权方对二次创作的限制不同,具体情况需作者自行判断。若版权方发起侵权投诉,平台将依法依规处理。
不可以。为避免内容安全风险,昵称和头像应使用SDK获取的用户信息或由系统随机生成,不允许用户自行创建。可提供预置候选昵称供用户选择。
需自行接入内容安全审核机制,防止被恶意输入违禁内容。
不得放置广告
不得跳转站外链接
不得侵犯他人版权
不得允许用户自建昵称/头像(需使用SDK或系统随机)
自由输入内容需自行接入内容安全审核
不得以锁死基础功能为条件提供附加体验,基础功能应保持可用
不得出现第三方平台登录/跳转
不得常驻式引导干扰体验
用户可自定义上传内容(UGC,如上传文字/图片/拍照、聊天室、画板等)属安全红线,平台正向「权限点审核」收敛,代码层面直接禁止未经授权的 UGC 能力。对于已接入内容安全审核的文本输入、且不允许用户上传底图的场景,仍需以平台审核结论为准。
请遵守内容安全底线,不涉政、不涉黄,不得侵权,不允许使用他人商标的。
请在显著位置明确标识「这并非真实银行 App 界面」等提示,避免误导用户,否则存在合规风险。
需保证版权合规。建议使用无版权或已获授权的素材,避免直接使用商用曲库内容。若版权方发起投诉,平台将依法依规处理。
跟热点可行,但须注意措辞与内容,不得涉黄涉政,不得违反社区公约及相关法律法规。
外部资源目前尚未禁止,但相关权限将逐步收敛,建议尽量减少对第三方资源的依赖;同时绝对禁止提供UGC能力(如聊天室、用户自由输入文字等),以内嵌框架实现聊天室同样不被允许。
不可以。Toy 默认自动登录 B站账号,禁止出现其他第三方平台的登录或跳转。
不可以。Toy 内不得提供爱发电、微信 / 支付宝收款码等第三方收款方式,违规会被限流或下线;如需引导充电,请引导用户到作者的B站个人主页进行。
不建议。b23 短链约一年后失效,到期会导致 Toy 打不开。
可以,但需自建后端,且不得收集用户个人敏感信息。
可以,自行实现即可,合规要求与在视频中感谢充电粉丝一致。
是的。Toy 内必须有一个用户不进行任何交互(关注、点赞等)也能看到的内容,不能所有内容都需关注或互动才能解锁。例如Toy 内至少有 1 个用户可以免费获取的内容 / 资料。
在B站App内具备登录态的用户访问才会计入浏览量。
Toy详情页顶部即可查看相关数据。

浏览量超过500后会被收录,每周一更新。数据统计截止至前一天24点,具体更新时间在当天内。
全新 Toy 广场已上线:在任意 Toy 详情页点击右上角广场图标即可进入,公开 Toy 将获得新的展示与曝光入口,并支持站内搜索。
>>Toy 广场入口<<

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

广场收录:选择「公开发布」即可被收录进 Toy 广场,无体验量限制。
「本周必玩」每周一晚更新,可在 App / Web 端搜索「Toy」进入 Toy 广场查看。
「本周必玩」收录规则:运营综合Toy当周体验量、互动数量、内容质量精选 6–10 个Toy发布,分为「娱乐」「工具」两条赛道(工具赛道相对不拥挤)。
提升入选概率:可参照Toy运营白皮书进行运营>>Toy运营白皮书
发布平台数据看板已新增「次日留存率」,单 Toy 明细与统计页均可查看。
系统自动推荐,游玩量高的作品会自动上榜,非人工操作,也不受其他因素干预。
可以。在 Toy 广场的「我创作的」中,可以查看自己 Toy 的全站 PV 排名。
平台已对识别出的异常访问数据做了修正,后续会加大风控和数据巡检力度。开发者也可对关键数值做服务端校验,避免被刷。
推流时长不固定,视频封面点击率越高,系统会给予更长的自动推流时间。一般提交推流申请后一天内即可推流,系统会显示「已推」并下发 B站私信通知。
填写时请按官方推流申请表格的要求,并带上指定的tag和话题。推流表格反馈一般在 24 小时内。
新游曝光是普遍难题,建议蹭热门标签、持续维护Toy活跃度、经常发视频、拉玩家群,推流效果也受首日数据影响;可参照Toy运营白皮书进行运营>>Toy运营白皮书
出于安全考虑,只有白名单内后缀的文件会被发布,其余文件(如可执行文件、后端脚本)会被自动过滤掉。平台支持哪些格式的文件,请查看Toy发布常见问题
目前暂不支持跨用户KV存储,该功能已在未来规划中。
联机功能需开发者自建后端服务,并利用云存档减轻服务器压力。
请检查URL是否完整,注意不要遗漏 index.html 后缀。
需要,确保压缩包根目录包含 index.html 文件,否则页面无法正常加载。
可直接使用正式环境,发布时选择“链接可见”或“密码可见”模式,再用小号进行测试即可。
可以引用外部资源;WebGPU 取决于 B站 App WebView 及系统/GPU/驱动是否支持(系统不支持则无法使用),建议用 WebGL/WebGL2 兜底,并在真机容器中测试。
预览是生效的,但预览页与真实环境格式可能略有差异;若遇到「预览正常但发布后打不开」等具体问题,请携带复现信息反馈官方排查。
建议不要在安全区(尤其顶部区域)放置交互元素;顶栏高度 SDK 有返回,整体避开即可。沉浸模式不影响按键位置,布局优化可借助 AI Agent 协助(如将设置收进二级菜单)。
Toy 不能通过 iframe 外链其他网页。
ThreeJS、Unity、Canvas 2D 等前端技术均可正常使用;Godot 对 Web 兼容性一般(3.x 尚可、4.x 后有较大变化且需全量下载),更适合单机,Web 向推荐前两者。
不同机型(安卓/苹果/平板)按键适配是公认难题,可在设置中允许玩家自行调节按键位置。
若被恶意刷分,可直接在管理端拉黑该账号封禁。官方已记录「允许开发者在排行榜上传成绩时自定义轻量 JS 校验」的方案,并在持续跟进反作弊通用能力。纯 B站排行榜难以彻底解决反作弊;核心思路是「每局后端运算结果」,而非依赖前端上报。
可用排行榜 Challenge 机制做弱版鉴权(用户须先通过公开排行榜完成挑战、关联 B站账号),再配合后端验签。
注意:查询充值/关注等前端校验均可能被破解,相关内容宜作为附加玩法或精神奖励,而非硬性门槛。
常见原因是包体默认开启了压缩,或包含 .mp4 视频文件。可尝试关闭压缩、移除视频文件或改为通过 CDN 加载后重新上传。
Cocos 引擎的 .cconb.bin 等文件会被打包流程过滤,使用前请确认脚本来源与安全性。
可以。平台并非仅支持纯前端,SDK 提供云存储与排行榜读写能力;自建后端服务、调用自有 API 需先开通相应权限,可在发布平台查询账号权限状态,未开通需走申请流程。
SDK 提供跳转能力:跳转自己的B站主页可以,跳转站外不允许,尺度与个人主页、视频简介保持一致;wiki.biligame.com 等可蓝链的站内域名不属于站外。
一是客户端版本过低,需升级至支持版本;二是建议做旋转自适应处理,旧版本用户在开启自适应后自行旋转屏幕即可横屏。
平台计划推出「调试版本」:免审、仅作者本人可见。现阶段建议使用两个Toy区分测试版与正式版,直接在正式环境中测试。
可通过 Toy 间跳转串联;「同用户不同 Toy 共享 KV」的开放能力正在开发中,跨用户共享 KV 也在规划中,现阶段可先在本地自行实现。
Toy 是前端网页,纯前端逻辑较容易被还原;建议把核心逻辑放到自建后端,并配合鉴权(如校验 B站用户身份)与官方 SDK,抬高对方盗用的成本。
可通过 Toy 间跳转串联;「同用户不同 Toy 共享 KV」已开放,可在发布平台「共享存档」创建存档标识,并授权合作作者使用(详见「三、SDK功能」——不同 Toy 之间可以共享存档吗?)。
可在 onContainerChange 里消费 viewport 变化并调用 game.scale.refresh()(配合延时重试兜底),即可恢复正常缩放。
目前平台正在规划更多查找路径。开发者可将相关动态置顶方便粉丝访问,也可建议粉丝收藏。
手机端公开 Toy 目前主要在动态里找,非公开的去发布页面找;PC 端可通过投稿中心-图文管理查看(含加密/隐藏动态)。
该问题为系统层面行为,可留意后续优化。iOS 上若默认浏览器非 Safari,添加到桌面可能直接打不开;官方已针对 Safari 做适配,其他浏览器缺失测试,已记录。
鸿蒙版 B站更新后已支持用户进入和使用 Toy,但暂不支持点赞、评论等互动功能,请开发者关注鸿蒙用户的使用情况。
支持,但功能完备程度低于国内主站,具体表现以实际版本为准。
沉浸模式下评论栏默认隐藏。
可以。现在用电脑浏览器使用 Toy,也能和 UP 主互动:支持点赞、评论、快捷关注 UP 主,还可以进入 Toy 广场发现更多作品。
工作人员会不定期查看消息,如有问题可随时留言,看到后会及时回复。
欢迎前往Toy开发者小站发帖交流:Toy开发者小站
指将Toy开发文档和SDK文档配置给AI编程助手,以辅助开发和调试。
权限申请于每周二、周四集中处理。已具备Toy权限的账号,登录后能正常进入发布页即可发布。
审核相关问题请查看内测群公告中的审核咨询入口,由专门审核人员对接;也可先自查是否存在用户自由输入、外链或不合规资源。
可在视频详情页提交侵权投诉,平台有对应流程处理。
Toy本身不直接产生收益,但优质内容带来的流量可间接为关联视频增加曝光,从而辅助视频收益。第三方广告不可行!
已知部分案例为「商单+视频」组合变现,主要取决于账号自身影响力。建议将Toy视为视频之外的一种内容表达形态。
暂不支持。
不支持支付功能,但可通过SDK检查用户是否包月充电,用于定制化体验。
充电查询目前仅限包月充电信息(非实时扣款),且为前端校验、可能被破解,建议用于额外玩法或精神奖励类内容。
创作版权属于作者,Toy 发布不影响在其他平台发布;但其他平台已发布内容能否再发 Toy,以该平台用户协议为准。Toy 不要求独家。
相关能力目前仍在开发中,暂未开放。此外,Toy 及其源码可作为资产在 B站小店售卖,代码资产归作者本人所有。
如有其他疑问,欢迎在评论区留言,或在Toy开发者小站发帖,我们会持续关注并完善本FAQ。祝各位开发顺利!
