推荐：将NSDT场景编辑器加入你的3D工具链

3D工具集：NSDT简石数字孪生

HUAWEI HMS Core 插件使用指南

目前 Cocos SDKHub 提供的华为 HMS Core 插件，包括了 游戏服务、应用内支付服务、广告服务、推送服务 和部分 账号服务，开发者需在 JS 层调用 Cocos SDKHub 接口，处理回调。

插件中的 账号 & 游戏服务、支付服务、广告服务 和 推送服务 均可独立使用。

Cocos SDKHub 框架和插件基本不涉及当前状态处理和服务端接口，例如当前用户是否登录等情况，需要游戏端进行判断，避免在用户未登录下，调用账号和游戏服务其他接口导致崩溃。华为 HMS Core 插件在支付成功情况下也做了本地验证。但如果用户需要登录或支付服务端验证（可选），请使用回调中的信息，自行到服务端进行验证。

准备工作

参考 AppGallery Connect 配置 文档，在 华为开发者联盟后台 注册开发者账号，创建游戏应用和 生成/配置签名证书指纹。在该游戏应用的 我的项目 -> 项目设置 -> API 管理 页面中开通 Account Kit、In-App Purchases、Game Service、Push Kit 服务。华为文档中的集成 HMS Core SDK 部分，Cocos SDKHub 会在构建时 自动完成，无需开发者手动操作。

• 若需要使用支付服务，请提前准备好注册开发者本人的银行卡，填写相关收款信息。提交后审核可能需要 1~2 个工作日。开通 In-App Purchases 服务后到后台 配置商品信息。支付服务支持 沙盒测试。请注意配置后的商品是否为 有效 状态。
• 若需要使用游戏服务，需要开发者 配置成就和事件，获取对应的 ID。
• 需要在已安装 HMS Core 服务的华为或荣耀品牌手机上测试。

配置华为参数文件

大部分的华为相关项目都需要用到 agconnect-services.json 配置文件。若有新开通服务等操作，请及时更新该文件。

• 登录 AppGallery Connect 后台，在 项目列表 -> 应用列表 中找到对应的应用。

在 项目设置 页面的 应用 区域，点击 agconnect-services.json 下载配置文件。agconnect-services.json 文件在下载或者更新完成后，必须手动拷贝 到工程目录的 settings 目录下。

注意：

1. 务必确认完成 生成/配置签名证书指纹 步骤，配置 SHA256 证书指纹。

2. 在构建时若勾选了 调试模式，开发者需要在 Android Studio 的 app/build.gradle 文件中，自行配置 Keystore 签名文件。

3. Cocos Creator v2.4.3 及以上版本，若 发布到 HUAWEI AppGallery Connect，开发者可直接在 构建发布 面板中选取下载或更新后的配置文件，不需要手动拷贝。

Sample 工程

开发者可以通过 Sample 工程快速体验 Cocos SDKHub。若开发者需要在自己的游戏工程中接入 HMS Core SDK，也可参考此流程。请先确保 准备工作 部分已经完成，并且已获取到所需参数。

• 点击 Cocos SDKHub 服务面板中的 Sample 工程 按钮，Clone 或下载，并在 Cocos Creator 中打开。

点击菜单栏的 面板 -> 服务，打开 服务 面板，选择 Cocos SDKHub，进入服务详情页。然后点击右上方的 启用 按钮即可开通服务。详情可参考 服务面板操作指南。

在 Cocos SDKHub 服务面板上添加一个新配置集

进入 添加配置集 页面，填写相关参数，填写完成后点击 确定 即可

添加完成后点击 配置插件 按钮，勾选所需的 HUAWEI HMS Core 相关服务插件。

点击 插件 行对应的编辑参数按钮。

进入 参数配置 页面，配置所需的参数。

支付公钥，勾选支付服务时需要填写。

语言支持

• 此参数为选填项。如果开发者的应用不需要设置只支持某些特定语言，该参数可以设置为空，应用将默认支持所有 HMS Core SDK 支持的语言。
• 如果开发者的应用需要设置只支持某些特定语言，填写格式为 "en", "zh-rCN", "需要支持的其他语言"。
• HMS Core SDK 支持的语言列表请参考文档 HMS SDK 支持的语言。
• 请在工程中的 config.js 文件中，替换支付商品 ID payProductId、请求商品信息 ID 列表 obtainProductIdList、成就 ID achievementId、排行榜 ID rankingId 和 事件 ID eventId。以上参数均可在 AppGallery Connect 后台 配置生成，可参考 配置商品信息 和 配置成就/事件。

配置完成并接入相关 API 接口后，即可通过 Creator 编辑器菜单栏的 项目 -> 构建发布 打开 构建发布 面板来构建编译工程。Creator 2.4.1 及以上版本，可参考 发布到 HUAWEI AppGallery Connect。旧版本用户可构建发布到 Android 平台。

• 若需要修改工程参数配置或者 JS 代码层，修改完成后，在构建发布面板重新构建即可。
• 若需要删减服务插件配置（例如去掉支付功能），建议删除工程构建后生成的发布包 build/jsb-link 或者 build/jsb-default 目录，然后重新构建。
• Sample 中提供了一个简单的消耗型商品消耗 consumeOwnedPurchase 流程，可供开发者参考。

由3D建模学习工作室 翻译整理，转载请注明出处!

上一篇：Cocos Service：Cocos SDKHub 快速入门 (mvrlink.com)

下一篇：Cocos Service：HUAWEI HMS Core 插件开发指南 (mvrlink.com)