鸿蒙端抖音小游戏适配指南
接入说明
抖音小游戏目前已支持在鸿蒙端(OpenHarmony 5.0+)游玩体验,为了鸿蒙端更好的游戏体验,本文将指引开发者为鸿蒙端进行专项适配。
支持范围
支持的游戏方案
支持的宿主
当前仅支持抖音;抖音极速版平台适配中,适配完成后已在抖音鸿蒙端上架的游戏将自动上架至抖音极速版鸿蒙端;其他宿主后续开放。
平台判断
支付
接入了支付能力的游戏需确保支付链路通畅,否则无法通过审核上线。
开放能力
鸿蒙端已支持大部分基础的开放能力,以保障小游戏主链路的通畅。暂未支持的开放能力如下:
能力 | 接口 | 备注 |
转发 | | |
关注 | | |
推荐流直出游戏能力 | | |
排行榜 | | |
媒体 | | |
开放数据域 | | |
开放数据 | | |
群聊 | | |
公会群 | | |
游戏站 | | |
直播 | | |
客服消息 | | |
抖音云 | | |
基础 | tt.setPreferredFramesPerSecond | |
对于不支持的接口,抖音会自动弹出 toast 提示给到玩家,同时会返回特定错误码和错误信息给开发者:
errNo | errMsg |
10302 | %s:fail The feature is not available in current operating system |
结算规则
开发者在鸿蒙系统的广告和内购收入,适用于《小游戏结算政策导览》中的现金结算规则、投放金规则(限时激励活动)、任务金规则(限时激励活动)。鸿蒙系统的内购收入按照 Android 端内购消费总额规则结算。
调试
普通小游戏于抖音开发者工具4.5.0及以上版本支持。
Unity WebGL 新包体于抖音开发者工具4.5.5及以上版本支持;目前可生成预览二维码,抖音鸿蒙端扫码自测。
模拟器调试
已增加对应设备的模拟器。
真机调试
抖音鸿蒙端直接扫码即可。
问题排查
WebSocket
- •鸿蒙端 WebSocket 通信偶现消息接收时序错乱,抖音鸿蒙端已在 39.1.0 版本修复。
- •鸿蒙WebSocket默认每30秒发送一个ping,若游戏的服务端不兼容标准WebSocket协议,就会自动断开,抖音鸿蒙端已在 39.8.0 版本修复,不再自动发ping。
