更新记录

4.18.9（2026-11-04） 下载此版本

修复鸿蒙进教室跳转问题。

4.18.8（2026-10-13） 下载此版本

修复鸿蒙系统无法进入教室问题

4.18.7（2026-09-18） 下载此版本

新增跳转设备检测页，OpenDeviceCheck方法；

平台兼容性

uni-app(5.13)

uni-app x(4.75)

其他

talkcloud-talkcloudplus 插件 API 文档

导入

import * as tkRoomManager from '@/uni_modules/talkcloud-talkcloudplus'

API 列表

配置

可选，需在进入房间前调用。

tkRoomManager.setConfig({
  deviceTesting: false // 跳过设备检测页
} as tkRoomManager.ConfigOption)

入房方式

1. 进入房间

tkRoomManager.joinRoomWithParams({
  serial: "******",
  nickname: "******",
  userrole: "2", // "2":学生 | "0":老师 | "4":巡课 | "6":旁听生

  // 进入房间成功
  onComplete: () => {
    console.log('onComplete')
  },
  // 进入房间错误, 错误码: https://showdoc.talk-cloud.com/web/#/115/1991
  onFailed: (result, desc) => {
    console.log(`onFailed result: ${result} , desc: ${desc}`)
  },
  // 房间状态变化
  onRoomState: (state) => {
    console.log(`onRoomState: ${state}`)
  },
  // 被踢出房间
  onKickOut: (reason) => {
    console.log(`reason: ${reason}`)
  },
  // 离开房间
  onLeaveRoom: () => {
    console.log('onLeaveRoom')
  },
  // 摄像头开启失败
  onOpenCameraError: () => {
    console.log('onOpenCameraError')
  },
  // 房间销毁
  onRoomDestroy: () => {
    console.log('onRoomDestroy')
  }
} as tkRoomManager.JoinRoomOptions)

JoinRoomOptions 参数

2. 进入回放房间

tkRoomManager.joinRoomWithPlaybackParams({
  serial: "******",
  recordtitle: "******"
} as tkRoomManager.JoinRoomPlaybackOptions)

JoinRoomPlaybackOptions 参数

3. 通过链接进入房间

tkRoomManager.joinRoomWithUrl("enterroomnew://******")

4. 通过 MP4 地址进入回放

tkRoomManager.joinRoomWithPlaybackPath({
  playUrl: "https://media.w3.org/2010/05/sintel/trailer.mp4", // 必选，MP4 播放地址
  // 以下可选，用于打点上报
  serial: "******",        // 课堂号（打点上报必选）
  userid: "******",        // 用户 ID（打点上报必选）
  recordtitle: "******",   // 视频标题（打点上报必选）
  companyid: "******",     // 企业 ID（仅 Android）
  starttime: 0,            // 开始播放时间毫秒（仅 iOS）
  playtype: 0,             // 0 浅色 1 深色（仅 iOS，默认 0）
  pauseOnAppBackground: false // 后台是否暂停（仅 iOS，默认 false）
} as tkRoomManager.PlaybackPathOptions)

PlaybackPathOptions 参数