Appearance
鸿蒙接入配置
WARNING
在接入SDK之前, 建议先请仔细阅读:接入流程
添加依赖库
将u8sdk.har文件,放到游戏工程主模块entry的libs目录下,然后在entry的oh-package.json中添加依赖配置。 如下图:

配置U8参数
将u8_developer_config.json文件放到entry的resource/rawfile目录下,里面配置含义如下:
json
{
"u8AppID": "1",
"u8AppKey": "855237c757b7420bb932110efa41263b",
"u8ChannelID": 32,
"u8Url": "http://172.16.3.200:12201"
}
u8AppID: U8SDK管理后台中该游戏的appID参数;
u8AppKey: U8SDK管理后台中该游戏的appKey参数;
u8ChannelID: U8SDK管理后台-》渠道配置中, 添加一条【华为鸿蒙】的渠道配置,生成或设置的渠道号;
u8Url: U8Server服务端访问地址参数说明:
| 参数名称 | 说明 |
|---|---|
| u8AppID | U8聚合SDK后台,该游戏的AppID参数 |
| u8AppKey | U8聚合SDK后台,该游戏的AppKey参数 |
| u8ChannelID | U8SDK管理后台-》渠道配置中, 添加一条【华为鸿蒙】的渠道配置,生成或设置的渠道号 |
| u8Url | U8聚合SDK的服务端地址 |
配置华为参数
在entry的module.json5中, 增加metadata参数项,如果已有metadata配置项,则在里面增加client_id和app_id两个配置项。
json
"metadata": [
{
"name": "client_id",
"value": "109427833"
},
{
"name": "app_id",
"value": "1270103954604227136"
}
]参数说明:
| 参数名称 | 说明 |
|---|---|
| client_id | 华为App Connect后台,项目详情中的oauth 2.0的client_id参数; |
| app_id | 华为App Connect后台, 项目详情中的AppID参数。 |
配置官网SDK登录
如果在鸿蒙中开启官网SDK登录, 需要增加额外配置:
1、 添加依赖库
在游戏工程总目录级别下的oh-package.json5文件中,添加微信和QQ登录的SDK依赖:
json
"dependencies": {
"@tencent/wechat_open_sdk": "1.0.16",
"@tencent/qq-open-sdk": "1.0.4"
}2、 添加跳转配置
在entry的module.json5中,modules节点下增加querySchemes:
json
"querySchemes": [
"weixin",
"wxopensdk",
"https",
"qqopenapi"
]在entry的module.json5中,abilities中当前游戏主Ability中,增加skill:
json
"skills": [
//...
{
"actions": [
"wxentity.action.open"
]
},
{
"entities": [
// entities必须包含"entity.system.browsable"
"entity.system.browsable"
],
"actions": [
// actions必须包含"ohos.want.action.viewData"
"ohos.want.action.viewData"
],
"uris": [
{
// scheme须配置为https
"scheme": "https",
// host须配置为关联的域名
"host": "www.u8sdk.com"
},
{
"scheme": "qqopenapi", // 接收 QQ 回调数据
"host": "1105950385", // 业务申请的互联 appId,如果填错会导致 QQ 无法回调
"pathRegex": "\\b(auth|share)\\b",
}
],
// domainVerify须设置为true
"domainVerify": true
}
]配置互通
按照华为官方文档中的说明,鸿蒙平台同时支持华为登录和官网SDK登录,需要满足账号互通要求:
1、需要让鸿蒙平台的华为账号和Android平台的华为账号互通;
2、需要让鸿蒙平台的官网SDK账号和其他平台官网SDK的账号互通。
如下图参考:

U8SDK中,每个渠道配置对应的账号是隔离的,如果需要让不同的渠道账号互通,需要将这些渠道配置相同的互通渠道号。也就是如下渠道的互通渠道号需要设置为同一个数值(比如999):
鸿蒙渠道 --> 999
华为Android渠道 --> 999
Android官网SDK渠道 --> 999
iOS官网SDK渠道 --> 999
其他需要互通的或使用官网SDK的渠道 --> 999如下图参考:
