FAQ
收藏本文旨在帮助开发者更快的查询文档、定位以及解决接入过程中遇到的问题。本文汇总了开发者接入过程中需要查阅的文档和在接入使用过程中常见的问题。
文档汇总
如何 接入抖音Unity小游戏与方案选择
方案选择
什么是native方案？什么是WebGL方案？如何选择？请参考文档：
WebGL方案说明
抖音Unity小游戏C# SDK接入
开放平台与普通小游戏
飞书反馈群：
接入与使用问题
接入调试问题
本地调试打开后提示meta服务错误
- •目前需要先发布一个测试版本
通过分享、桌面快捷方式、微端进入游戏提示meta服务错误
- •外部用户渠道，需要有经过审核的线上版本才能进去
- •关注和收藏相关的功能需要提交到线上才可以验证。
- •包括创建的快捷方式拉起，也需要正式发布到线上之后才可以验证。
添加快捷方式/下载快捷方式（miniapk）失败
- •Android需要事先允许app创建快捷方式/安装应用
miniapk打开后提示meta服务错误
- •先确定游戏是否发布过正式版本，miniapk跳转的是线上正式版本
appid的存储空间更改
- •请在反馈群中询问
相同代码，Unity 2021 版本打出的apk包体比Unity 2019打出的包体大
- •Unity Build Settings -> IL2CPP Code Generation，切换到Faster (smaller) builds
C# SDK问题
接口不知道怎么用，有没有demo
怎么判断哪些接口可用
- •使用
StarkSDKSpace.CanIUse来判断该接口是否可用抖音Unity小游戏需要额外添加防沉迷和实名认证吗
- •不用，抖音Unity小游戏自带了相关能力
抖音Unity小游戏支持打开外链吗？
- •暂时不支持外链
广告接口返回100x错误
- •查看小程序开发平台关于广告错误码的说明
广告返回1004
- •没有适合的广告，属于正常情况，且开发者需要针对这种情况做形态上的兼容。
为什么插屏广告经常看不到？
- •初次进入的时候，需要等待15秒才可以做第一次的展示。
- •后续的插屏广告需要间隔30s
- •同一个广告只能展示一次。
为什么视频广告出不来？
- •需要看下错误码，根据错误码来排查。
- •提交验收的包需要使用自己正式申请到的appID和相关广告ID。
- •接口相关的使用规则：
- ◦新接口从抖音Unity小游戏的3.4版本开始支持：StarkSDK.API.GetStarkAdManager().ShowVideoAdWithId()
- ▪抖音宿主: 13.4.0 开始支持
- ▪头条宿主: 7.9.6 开始支持
- ▪抖音Lite宿主: 7.6.9开始支持
- ▪头条Lite宿主：暂不支持
- ◦老接口从抖音Unity小游戏的3.10版本开始不再支持：StarkSDK.API.GetStarkAdManager().ShowVideoAd()
关于录屏你需要知道的？
- •录屏时长不能低于3秒。
- •首次加载游戏之后，建议不要默认开启视频分享按钮。
- •分享失败或者其他提醒的时候，建议走toast提示。
录屏分享失败
- •报错信息：ERROR/StarkShareImpl: Share failed, err: -1, errMsg: get shareInfo return null
- •原因：游戏被下架，被封禁分享和搜索
Unity游戏是否有域名限制？
- •目前没有，未来可能会加
排行榜提示网络异常
- •需要先确认是否已经登录
支付报错10401
- •支付需要保证用户已经登录，可以调用StarkSDK.API.GetAccountManager().Login接口，也可以调用StarkSDK.API.GetAccountManager().CheckSession检查session有效性
加入群聊失败，返回“OnFailed，code2190004，msg:无权访问”
- •粉丝 群的群主到游戏中进行“获取群聊信息”授权，授权后恢复权限
无法测试从侧边栏进入到测试环境的游戏
- •添加测试设备，加入调试成员后，在抖音【我】右上角更多按钮-更多功能-开发者模式-打开开发者模式-对应的游戏-打开全入口打开指定版本小游戏-扫码选择指定版本，这样就可以在点击侧边栏的时候进入到测试版本
Native方案
Unity支持的版本(Android native方案)
- •2021.3.14f1
- •2022.3.34f1
- •团结引擎1.1.4
WebGL方案
iOS WebGL提示“当前系统版本不支持运行，请升级系统版本”
- •iOS 13.4以下以及iOS 15.4.0、15.4.1版本不支持
WebGL 如何拉起键盘
- •调用StarkSDK.API.GetStarkKeyboard().ShowKeyboard，并查看该api的相关注释
iOS WebGL录屏报错不支持
- •当前iOS系统限制，对性能要求较高。为了用户更好的体验，所以对iphonexr以下机型没有打开可见性入口
- •iOS上的录屏功能会有权限申请，还有性能消耗，不建议使用。一定要使用，dau达到10万后，跟平台运营同学联系开白名单。（平台只要求android上要录屏分享）
WebGL 报错 RuntimeError: Out of bounds memory access (evaluating 'dynCall_xxxx')
这个问题一般有两种可能：
- •使用iOS 15.4.0或15.4.1系统，但没有采用wasm分包。
- ◦该问题为 Unity 与 iOS 15.4.x 的 BUG，推荐使用我们提供的 WebGL 分包工具或采用Unity WebGL官方论坛的修复方案:
- •C#代码逻辑有问题，或者C#代码在WebGL平台下不支持。如果是这个问题，需要 编译一个带符号的版本重新发布，然后看详细错误信息，需要自行排查是哪个函数报错。
- ◦编译带符号版本: PlayerSettings -> Publishing Settings -> Debug Symbols -> Embeded。
WebGL Android提示当前32位手机不支持
- •WebGL Android仅支持64位
WebGL Android部分机型渲染黑屏
- •渲染引擎导致，之后会升级渲染引擎
游戏界面被覆盖或切后台后返回，背景音乐失效，音效失效
- •使用C# SDK内置的音频接口
是否支持WebGL2.0？
- •iOS：仅支持iOS 15.0及以上系统
- •Android WebGL：暂时不支持WebGL2.0，如果使用WebGL2.0，Android平台需要使用Native方案
iOS 16.7-17.0版本切后台出现渲染卡死问题
- •iOS系统bug导致，在切后台一段时间后导致"WebGL: context lost."，致使Unity无法继续渲染。
- •苹果在iOS 17.1版本修复了该问题：https://developer.apple.com/documentation/safari-release-notes/safari-17_1-release-notes
iOS 16.7-17.0版本启动出现js报错：null is not an object (evaluating 'result.rangeMin'),_glGetShaderPrecisionFormat
- •同上个问题，context lost导致
called non-existent method UnityEngine.Cache报错
- •需要检查是否是使用了UnityEngine.Caching相关的接口：https://docs.unity3d.com/ScriptReference/Caching.html
- •暂时不支持Unity2022版本
调用HttpWebRequest导致游戏卡住
- •HttpWebRequest在WebGL下不支持，需要替换成UnityWebRequest
WebGL 如何设置帧率
- •WebGL 平台下默认帧率为 60，通过 Application.targetFrameRate 可以设置帧率：
Application.targetFrameRate = 30; // 设置为 30 帧
- •设置帧率无效时，需要关闭垂直同步：
QualitySettings.vSyncCount = 0; // 不为 0 时，帧率会被强制设为 60 ÷ vSyncCount。
- •设置的帧率应当可被 60 整除，建议值为 60、30、15。
- ◦不能被 60 整除或超过 1000 的值会造成帧率不稳定或与预期帧率不一致。
插件工具相关
构建工具
请问这个BGDT没有使用权限要怎么处理
请问点击运行本地apk或者构建并真机运行，都不能启动真机上的程序是什么原因，也没有报错？
- •宿主上的插件还没安装完
- ◦针对这类问题，抖音安装好了之后，需要登录下抖音，进入随便运行一个抖音Unity小游戏即可。如果没有发布过可以搜索一下《超级挖坑大师》
- •手机是否是android11的系统，看下push apk包是否成功（通过控制台日志查看）
发布的时候提示uid没有权限？
- •如果是初次发布，版本号需要自定义一下，比如输入0.0.1
- •如果非初次发布，且已经有相关的发布版本，可以直接在话题群咨询。
发布工具
我发布的时候出现了各类问题该如何自查？
- •第一步： 确保你的操作步骤是按照文档来的。
- •第二步：检查Unity版本号信息, 抖音Unity小游戏只支持使用指定版本（注意：通过官网，不能通过unityhub下载，要用浏览器下载）
- •第三步：更新工具版本
- ◦更新BGDT工具版本到最新的版本
- ◦更新UnitySDKTools 到最新的版本
md5检测失败 code:10002 error:apk check failed
- •建议先使用空工程进行发布测试
- •确认使用的unity版本是指定版本。官方下载页面（认准.com域名）：
- •NDK，JKD，SDK安装：
- •确认使用il2cpp并且关闭StripEngineCode
- •关闭DevelopmentBuild
- a.
文件类型错误 code: 10002 msg: invalid apk file, not support file type: .apk?=
- •一般是使用的文件路径带有中文。更新发布工具可解决
场景中的Render Mode 选择的是Screen Space -OverLay
- •参考 URP下录制视频注意事项
游戏接入相关
基本接入流程：
必备基础知识
1、验收相关：
- •抖音Unity小游戏（unity解决方案）在合规及提审方面的要求与普通小游戏对齐，请务必先阅读抖音开放平台相关文档https://developer.open-douyin.com/docs/resource/zh-CN/mini-game/operation1/agreement-and-norms/norms/standards
- •同时我们提供了一份关于功能性的自测checkList以帮助开发者更好的完成首次上线
2、关注抖音号：
- •提前申请开通的话需要拷贝一个副本抖音号关注信息 知会给对接群。
3、常规的兜底：
- •资源加载失败(弱网、断网)的时候需要有兜底页面，即重试。
- •广告加载失败(弱网、断网)的时候需要有兜底页面，不要一直等待。
4、包体相关：
- •用户启动游戏的时间，一般来说，启动越快，取消率越低，转化率越高。为保证用户体验，在小游戏平台上线，我们对首包大小有如下约束:
- •使用 原生 方案，首包包体需 小于100M
- •使用 Wasm 方案，首包包体需 小于100M
