Interface NIMInterface

关联函数

• NIMGetInstanceOptions.onconnect

示例

nim.disconnect({
  done: function() {
    nim.connect()
  }
})

注意，在9.9.0以及之前版本，调用 destroy 后，会直接触发 ondisconnect 回调函数，但此时长连接并未真正销毁。只有在 done 回调触发时才能保证长连接真正销毁。为了避免重连时多端互踢，用户应该在 destroy 的 done 回调中设置重连等操作

关联函数

• NIMGetInstanceOptions.ondisconnect

示例

nim.destroy({
  done: function(err) {
    if (err) {
      console.log('销毁实例失败', err)
    } else {
      console.log('销毁实例成功')
      nim = null
    }
  }
})

注意，在9.9.0以及之前版本，调用 destroy 后，会直接触发 ondisconnect 回调函数，但此时长连接并未真正销毁。只有在 done 回调触发时才能保证长连接真正销毁。为了避免重连时多端互踢，用户应该在 destroy 的 done 回调中设置重连等操作

关联函数

• NIMGetInstanceOptions.ondisconnect

示例

nim.disconnect({
  done: function(err) {
    if (err) {
      console.log('断开连接失败', err)
    } else {
      console.log('断开连接成功')
    }
  }
})

注1: 0 的未登录包含了初始状态和登录失败的状态

注2: 3 的处于重连退避间隔中, 开发者不需要重新调用登录接口, 到期后 SDK 会自动重连.

示例

var status = nim.getLoginStatus()
switch (status) {
  case 0:
    console.log('未登录')
    break
  case 1:
    console.log('已登录')
    break
  case 2:
    console.log('登录中')
    break
  case 3:
    console.log('重连退避中')
    break
}

关联函数

• NIMGetInstanceOptions.ondisconnect
• NIMGetInstanceOptions.onloginportschange

示例

// 踢掉其他端
nim.kick({
  deviceIds: ['device-id-1', 'device-id-2'],
  done: function(err) {
    if (err) {
      console.log('踢掉其他端失败', err)
    } else {
      console.log('踢掉其他端成功')
    }
  }
})

使用场景

任何需要更新初始化参数配置的场景。例如：

• 采用动态 token 登录时，可通过该 API 更新动态 token。
• 采用静态 token 登录时，如果需要刷新了静态 token，可通过该 API 更新静态 token。

IM 登录相关详情，请参见初始化并登录 IM。

示例

// 更新动态 token
nim.setOptions({
  authType: 'token',
  token: 'new-dynamic-token'
})

示例

// 进入休眠模式
nim.setPowerMonitorStatus(1)

// 退出休眠模式
nim.setPowerMonitorStatus(0)