更新记录

1.0.0（2025-07-11）

无

平台兼容性

云端兼容性

uni-app(4.75)

uni-app x(4.75)

TUICallKit 组件

简介

TUICallKit 是腾讯云实时音视频（TRTC）推出的一款音视频通话组件，适用于uni-app项目，支持单人和多人音视频通话场景。

主要功能

• 一对一音视频通话
• 群组音视频通话
• 通话接听、拒绝、挂断
• 加入已有通话
• 悬浮窗功能

快速开始

初始化与登录

import { init, login, setSelfInfo } from '@/uni_modules/miko-TUIRoomKit'

// 初始化SDK
init({
  sdkAppId: 1400000001, // 替换为您的SDKAppID
  sdkSecretKey: 'xxxxxxxxxxxx', // 替换为您的密钥
  success: (res) => {
    console.log('初始化成功', res)

    // 登录
    login({
      userId: 'user123',
      success: (res) => {
        console.log('登录成功', res)

        // 设置用户信息
        setSelfInfo({
          nickname: '测试用户',
          avatar: 'https://example.com/avatar.png'
        })
      }
    })
  }
})

发起通话

import { call } from '@/uni_modules/miko-TUIRoomKit'

// 定义媒体类型常量
const TUICallMediaType = {
  UNKNOWN: 0,
  AUDIO: 1, // 音频通话
  VIDEO: 2  // 视频通话
}

// 发起视频通话
call({
  userId: 'user456', // 被呼叫用户ID
  mediaType: TUICallMediaType.VIDEO, // 视频通话
  success: (res) => {
    console.log('发起视频通话成功', res)
  }
})

使用指南

详细的使用方法和API说明，请参考 使用文档

示例代码

完整的示例代码可参考 示例项目

权限说明

TUICallKit 需要使用摄像头、麦克风、网络等权限，详细权限列表和配置方法请参考使用文档的权限管理部分。

Android 权限配置

// manifest.json
{
  "app-plus": {
    "permissions": [
      "android.permission.RECORD_AUDIO",
      "android.permission.CAMERA",
      "android.permission.MODIFY_AUDIO_SETTINGS",
      "android.permission.BLUETOOTH",
      "android.permission.SYSTEM_ALERT_WINDOW"
    ]
  }
}

iOS 权限配置

// manifest.json
{
  "app-plus": {
    "ios": {
      "privacyDescription": {
        "NSCameraUsageDescription": "用于视频通话，允许使用相机权限",
        "NSMicrophoneUsageDescription": "用于语音通话，允许使用麦克风权限",
        "NSLocalNetworkUsageDescription": "用于通话，允许使用本地网络"
      }
    }
  }
}