抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台

鸿蒙端抖音小游戏适配指南

收藏
我的收藏

接入说明

抖音小游戏目前已支持在鸿蒙端(OpenHarmony 5.0+)游玩体验,为了鸿蒙端更好的游戏体验,本文将指引开发者为鸿蒙端进行专项适配。
​

支持范围

支持的游戏方案

方案
是否支持
备注
普通小游戏(cocos/laya/egret)
是
抖音36.8.0及以上版本
Unity WebGL
是
抖音39.5.0及以上版本支持,开发者需按照指引更新为新包体,并将TTSDK升级到6.7.9及以上,如不满足则不允许上线
Unity Native
否
暂无计划支持,但开发者可以按照指引更新为新包体,并勾选Android端使用Native方式渲染,Android端会继续使用Native产物,鸿蒙端(抖音39.9.0及以上版本)和iOS端则会使用WebGL产物来运行游戏,TTSDK需要升级到6.7.9及以上,如不满足则不允许上线

支持的宿主

当前仅支持抖音;抖音极速版平台适配中,适配完成后已在抖音鸿蒙端上架的游戏将自动上架至抖音极速版鸿蒙端;其他宿主后续开放。
​

平台判断

tt.getSystemInfo和tt.getSystemInfoSync返回的platform为openHarmony。
​

支付

支付API对齐Android,使用tt.requestGamePayment,目前仅支持现金支付。
接入了支付能力的游戏需确保支付链路通畅,否则无法通过审核上线。
​

开放能力

鸿蒙端已支持大部分基础的开放能力,以保障小游戏主链路的通畅。暂未支持的开放能力如下:
对于不支持的接口,抖音会自动弹出 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。
​
​
​