文档中心

绑定游戏官方账号

玩家首次登录HarmonyOS NEXT游戏，通过绑定华为玩家标识与游戏官方账号，可实现华为账号或游戏官方账号在HarmonyOS NEXT设备上快速登录游戏，两种登录方式下游戏进度保持同步。因此，为了提升玩家体验，建议在游戏中提供绑定游戏官方账号的功能。

前提条件

已实现初始化。
调用unionLogin接口获取的needBinding值为true。

开发步骤

调用bindPlayer接口绑定teamPlayerId与游戏官方账号thirdOpenId 。

let context = getContext(this) as common.UIAbilityContext;
let thirdOpenId = '123xxxx'; // thirdOpenId表示游戏官方账号ID
let teamPlayerId = '456xxx'; // teamPlayerId表示玩家华为账号对应的teamPlayerId
try {
  gamePlayer.bindPlayer(context, thirdOpenId, teamPlayerId).then(() => {
    hilog.info(0x0000, 'testTag', `Succeeded in binding.`);
  }).catch((error: BusinessError) => {
    hilog.error(0x0000, 'testTag', `Failed to bind. Code: ${error.code}, message: ${error.message}`);
  });
} catch (error) {
  let err = error as BusinessError;
  hilog.error(0x0000, 'testTag', `Failed to bind. Code: ${err.code}, message: ${err.message}`);
}

解绑游戏账号

为了考虑玩家的用户体验，游戏需为玩家提供解绑功能。接入步骤如下：

在游戏内为玩家提供一个解绑按钮。按钮常见的位置如下：
说明

建议解绑按钮的按钮名称为“解除关联”、“关联解除”、“账号解绑”、“解绑按钮”、“解绑”等，表达出解除绑定的意思即可，避免和切换账号、退出登录、删除账号、注销账号等概念混淆。

【选择区服界面】

【玩家用户中心界面】

【游戏内的设置界面】
玩家点击解绑按钮时，建议游戏弹出解绑窗口，窗口文案建议为“您正在解除当前华为账号和游戏官方账号的关联关系，解绑后可以继续使用游戏官方账号登录游戏，但无法使用当前华为账号一键登录。”。样例图如下：

玩家点击窗口的“立即解绑”后，游戏需请求解绑账号接口或调用unbindPlayer接口解除teamPlayerId与游戏官方账号thirdOpenId的绑定关系。解绑成功后，建议游戏退出到登录界面后调用unionLogin接口，重新拉起联合登录面板，允许玩家重新选择游戏的登录方式。