# OnlineBattleManager.connect(Object option)
以 Promise 风格调用:支持
# 功能描述
连接多人联机服务器,返回playerId(玩家全局唯一标识)。连接成功后才能进行后续的房间操作和对战功能。
# 参数
# Object option
| 属性 | 类型 | 默认值 | 必填 | 说明 |
| success | function | 否 | 接口调用成功的回调函数 | |
| fail | function | 否 | 接口调用失败的回调函数 | |
| complete | function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
# option.success 回调函数
# 参数
# Object res
| 属性 | 类型 | 说明 |
| playerId | string | 玩家ID - 服务器分配的全局唯一标识 |
| errMsg | string | 成功时为 "connect:ok" |
# option.fail 回调函数
# 参数
# Object err
| 属性 | 类型 | 说明 |
| errMsg | string | 错误信息 |
| errno | string | 错误码 |
# 示例代码
let tapOnlineBattle = tap.getOnlineBattleManager();
// 回调风格
tapOnlineBattle.connect({
success: (res) => {
console.log('连接成功,玩家ID:', res.playerId);
},
fail: ({errMsg, errno}) => {
console.error('连接失败:', errMsg, errno);
},
complete: ({errMsg, errno}) => {
console.log('连接完成:', errMsg);
}
});
// Promise风格
tapOnlineBattle.connect()
.then(res => {
console.log('连接成功,玩家ID:', res.playerId);
})
.catch(error => {
console.error('连接失败:', error);
});
