鸿蒙接入配置

WARNING

在接入SDK之前， 建议先请仔细阅读：接入流程

添加依赖库

将u8sdk.har文件，放到游戏工程主模块entry的libs目录下，然后在entry的oh-package.json中添加依赖配置。 如下图：

配置U8参数

将u8_developer_config.json文件放到entry的resource/rawfile目录下，里面配置含义如下：

{
  "u8AppID": "1",
  "u8AppKey": "855237c757b7420bb932110efa41263b",
  "u8ChannelID": 5167,
  "u8Url": "http://172.16.3.16:12201",
  "u8PrivacyUrl": "http://www.u8sdk.com/privacy/xsdk_privacy.html",
  "u8UserUrl": "http://www.u8sdk.com/privacy/xsdk_privacy.html",
  "u8Plugins": [
    {
      "name": "ReYunAnalytics",
      "type": "analytics",
      "params": {
        "appKey": "3cffe63a899c9586",
        "enableLog": "true"
      }
    },
    {
      "name": "GDTAnalytics",
      "type": "analytics",
      "params": {
        "actionSetId": "1220774454",
        "secretKey": "77af07601a3c4c1f47f7854ad5844bf1",
        "enableLog": "true"
      }
    }
  ]
}

参数说明：

参数名称	参数类型	参数说明
u8AppID	string	U8SDK后台该游戏对应的AppID参数
u8AppKey	string	U8SDK后台该游戏对应的AppKey参数
u8ChannelID	string	U8SDK后台-渠道配置中创建一个【U8测试平台】，设置的对应的渠道号
u8Url	string	聚合SDK服务的URL地址
u8PrivacyUrl	string	如果使用U8SDK的隐私弹窗，这里配置为游戏隐私协议URL
u8UserUrl	string	如果使用U8SDK的隐私弹窗，这里配置为游戏用户协议URL
u8Plugins	list	插件参数配置，目前支持热云/广点通等，根据需要进行配置，如果用不到可以不配置

配置华为参数

在entry的module.json5中， 增加metadata参数项，如果已有metadata配置项，则在里面增加client_id和app_id两个配置项。

"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依赖：

"dependencies": {
  "@tencent/wechat_open_sdk": "1.0.16",
  "@tencent/qq-open-sdk": "1.0.4"
}

2、 添加跳转配置

在entry的module.json5中，modules节点下增加querySchemes:

"querySchemes": [
  "weixin",
  "wxopensdk",
  "https",
  "qqopenapi"
]

在entry的module.json5中，abilities中当前游戏主Ability中，增加skill:

"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

如下图参考：