OnlineBattleManager.updatePlayerCustomProperties(Object option)

以 Promise 风格调用：支持

功能描述

更新玩家自定义属性（如昵称、等级、头像）。属性变更会触发所有玩家（包括发送者自己）的 onPlayerCustomPropertiesChange 事件。

参数

Object option

属性	类型	默认值	必填	说明
properties	string		是	自定义玩家属性（UTF-8字符串，最大2048字节）
success	function		否	接口调用成功的回调函数
fail	function		否	接口调用失败的回调函数
complete	function		否	接口调用结束的回调函数（调用成功、失败都会执行）

注意事项

• customProperties最大2048字节
• 超过大小限制会导致设置失败

示例代码

let tapOnlineBattle = tap.getOnlineBattleManager();

// 回调风格
tapOnlineBattle.updatePlayerCustomProperties({
  properties: "user_newCustomPlayerProperties",
  success: (res) => {
    console.log('更新玩家属性成功');
  },
  fail: ({errMsg, errno}) => {
    console.error('更新玩家属性失败:', errMsg);
  }
});

// Promise风格
tapOnlineBattle.updatePlayerCustomProperties({
  properties: "user_newCustomPlayerProperties"
}).then(res => {
  console.log('更新玩家属性成功');
}).catch(error => {
  console.error('更新玩家属性失败:', error);
});