Skip to content

鸿蒙接入配置

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服务端访问地址

参数说明:

参数名称说明
u8AppIDU8聚合SDK后台,该游戏的AppID参数
u8AppKeyU8聚合SDK后台,该游戏的AppKey参数
u8ChannelIDU8SDK管理后台-》渠道配置中, 添加一条【华为鸿蒙】的渠道配置,生成或设置的渠道号
u8UrlU8聚合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

如下图参考:

账号互通配置

版权所有© 2021-2030 上海丞诺网络科技有限公司