产品动态
产品近期公告
关于 TRTC Live 正式上线的公告
关于TRTC Conference 正式版上线的公告
Conference 商业化版本即将推出
关于多人音视频 Conference 开启内测公告
关于音视频通话 Call 正式版上线的公告
关于腾讯云音视频终端 SDK 播放升级及新增授权校验的公告
关于 TRTC 应用订阅套餐服务上线的相关说明
Flutter
本文将介绍如何快速接入 TUICallKit 组件。您可以在 10 分钟内完成以下关键步骤，最终获得一个功能完备的音视频通话界面。
准备工作
环境要求
Flutter 3.10.0、Dart 3.0 及以上版本。
开通服务
快速接入
步骤1: 导入插件
flutter pubaddtencent_calls_uikit
步骤2: 工程配置
原生工程配置：
1. 由于 SDK 内部使用了 Java 反射机制（或特性），需要将部分 SDK 类加入不进行混淆处理的名单。
请在工程的
android/app/build.gradle 文件中配置并开启混淆规则：android {......buildTypes {release {......minifyEnabled trueproguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'}}}
在工程的
android/app 目录下创建 proguard-rules.pro 文件，并在其中添加如下代码：-keep class com.tencent.** { *; }
2. 在工程的
android/app/build.gradle 文件中配置开启 Multidex 支持。android {......defaultConfig {......multiDexEnabled true}}
因为 TUICallKit 需要使用音视频功能，您必须获取麦克风和摄像头的授权。
授权操作方法：在您的 iOS 工程的
Info.plist 文件中，在顶级 <dict> 目录下添加以下两项。<key>NSCameraUsageDescription</key><string>CallingApp需要访问您的相机权限，开启后录制的视频才会有画面</string><key>NSMicrophoneUsageDescription</key><string>CallingApp需要访问您的麦克风权限，开启后录制的视频才会有声音</string>
Flutter 工程配置
在 Flutter 应用框架的 navigatorObservers 中添加 TUICallKit.navigatorObserver，以下是使用 MaterialApp 框架的示例代码：
import 'package:tencent_calls_uikit/tencent_calls_uikit.dart';......class XXX extends StatelessWidget {const XXX({super.key});@overrideWidget build(BuildContext context) {return MaterialApp(navigatorObservers: [TUICallKit.navigatorObserver],......);}}
步骤3: 登录
在您的项目中添加如下代码，它的作用是调用
login 接口完成插件的登录。此步骤至关重要：只有成功登录后，您才能正常使用 TUICallKit 提供的各项功能。login
import 'package:tencent_calls_uikit/tencent_calls_uikit.dart';import 'package:tencent_calls_uikit/debug/generate_test_user_sig.dart';......final String userID = 'xxxxx'; // 请替换为您的 UserIdfinal int sdkAppID = 0; // 请替换为第一步在控制台得到的 SDKAppIDfinal String secretKey = 'xxxx'; // 请替换为第一步在控制台得到的 SecretKeyvoid login() async {String userSig = GenerateTestUserSig.genTestSig(userID, sdkAppID, secretKey);TUIResult result = await TUICallKit.instance.login(sdkAppID, userID, userSig);if (result.code.isEmpty) {print('Login success');} else {print('Login failed: ${result.code} ${result.message}');}}
参数 | 类型 | 说明 |
userID | String | 客户根据自己的业务自定义用户 ID，只允许包含大小写英文字母(a-z A-Z)、数字(0-9)及下划线和连词符。 |
sdkAppID | int | |
secretKey | String | |
userSig | String | 一种安全保护签名，用于对用户进行登录鉴权认证，确认用户是否真实，阻止恶意攻击者盗用您的云服务使用权。 |
说明：
开发环境：如果您在本地开发调试阶段，可以采用本地
GenerateTestUserSig.genTestSig函数生成 userSig。该方法中 secretKey 很容易被反编译逆向破解，一旦您的密钥泄露，攻击者就可以盗用您的腾讯云流量。生产环境：如果您的项目要发布上线，请采用 服务端生成 UserSig 的方式。
步骤4: 设置昵称和头像 [可选]
首次登录的用户没有头像和昵称信息，您可以通过
setSelfInfo 接口设置头像和昵称：setSelfInfo
import 'package:tencent_calls_uikit/tencent_calls_uikit.dartvoid _setSelfInfo() {String nickname = "jack"String avatar = "https:/****/user_avatar.png"TUIResult result = TUICallKit.instance.setSelfInfo(nickname, avatar);}
参数 | 类型 | 说明 |
nickname | String | 目标用户的昵称。 |
avatar | String | 目标用户的头像。 |
步骤5: 发起通话
拨打方可以通过调用
calls 函数，并指定媒体类型和被叫方用户 ID 列表，来发起语音或视频通话。calls 接口同时支持一对一通话和多人通话。当 userIdList 中包含一个 userId 时，为一对一通话；当 userIDList 包含多个 userId 时，则为多人通话。calls
import 'package:tencent_calls_uikit/tencent_calls_uikit.dart';......void _call() {List<String> userIdList = ['vince'];TUICallMediaType mediaType = TUICallMediaType.audio;TUICallParams callParams = TUICallParams();TUICallKit.instance.calls(participantIds, mediaType, callParams);}
参数 | 类型 | 说明 |
userIdList | List<String> | 目标用户的 userId 列表。 |
mediaType | 通话的媒体类型，例如视频通话、语音通话。 | |
params | 通话扩展参数，例如房间号、通话邀请超时时间，离线推送自定义内容等。 |
步骤6: 接听通话
接听端完成登录后，拨打端发起通话，接收端就可以收到通话邀请，同时伴随铃声和振动。
更多功能
开启悬浮窗功能
您可以通过调用 enableFloatWindow 开启/关闭悬浮窗功能，在初始化 TUICallKit 组件时启用该功能，默认状态为关闭（false）。可通过点击通话界面左上角的悬浮窗按钮，将通话界面缩小为悬浮窗形式。
enableFloatWindow
import 'package:tencent_calls_uikit/tencent_calls_uikit.dart';......void _enableFloatWindow() {TUICallKit.instance.enableFloatWindow(true);}
详情：默认为 false，通话界面左上角的悬浮窗按钮隐藏，设置为 true 后显示。
开启来电横幅
您可以通过调用
enableIncomingBanner 开启/关闭来电横幅显示，该功能默认为关闭状态（false）。当被叫端收到来电时，默认展示全屏通话等待界面。启用此功能后，将首先显示一个横幅通知，然后根据需要切换到全屏通话界面。请注意，显示来电横幅需要授予悬浮窗权限，具体的显示策略将根据权限设置及应用当前是否在前台或后台运行来决定。
enbalecomingBanner
import 'package:tencent_calls_uikit/tencent_calls_uikit.dart';......void _enableFloatWindow() {TUICallKit.instance.enableIncomingBanner(true);}
详情：默认为 false，被叫端收到邀请后默认弹出全屏通话等待界面。开启后先展示一个横幅，然后根据需要拉起全屏通话界面。
多人通话
主叫方使用
calls 方法发起通话时，若被叫用户列表超过一人，则自动视为群组通话。其他成员可通过 join 方法加入该多人通话。发起多人通话：使用
calls 方法发起通话时，若被叫用户列表（userIdList）超过一人，则自动视为群组通话。calls
import 'package:tencent_calls_uikit/tencent_calls_uikit.dart';void _call() {List<String> userIdList = ['vince','mike'];TUICallMediaType mediaType = TUICallMediaType.audio;TUICallParams callParams = TUICallParams();TUICallKit.instance.calls(participantIds, mediaType, callParams);}
参数 | 类型 | 说明 |
userIdList | List<String> | 目标用户的 userId 列表。 |
mediaType | 通话的媒体类型，例如视频通话、语音通话。 | |
params | 通话扩展参数，例如房间号、通话邀请超时时间，离线推送自定义内容等。 |
加入多人通话：可使用
join 方法加入指定的群组通话。join
import 'package:tencent_calls_uikit/tencent_calls_uikit.dart';void join() {String callId = "123456";TUICallKit.instance.join(callId);}
参数 | 类型 | 说明 |
callId | String | 此次通话的唯一标识。 |
语言设置
支持的语言：目前支持简体中文、英文和日文，默认语言为英文 。
切换语言：TUICallKit 不提供单独的语言切换接口。其界面语言将自动跟随当前应用程序根组件（如 MaterialApp 或 CupertinoApp）所使用的语言设置而切换。 您只需更改应用根组件的语言配置即可实现通话界面的语言切换。
说明：
如需设置其他语言，请联系我们（info_rtc@tencent.com）获取协助。
铃声设置
您可通过以下方式设置默认铃声、来电静音模式、离线推送铃声：
设置默认铃声（方式2）：通过
setCallingBell 接口设置被叫端收到的来电铃声。setCallingBell
import 'package:tencent_calls_uikit/tencent_calls_uikit.dart';......void _setCallingBell() {TUICallKit.instance.setCallingBell('flieName');}
详情：设置的铃声需要是主工程的资源文件，需要在主工程的 pubspec.yaml 文件中完成配置。
参数 | 类型 | 说明 |
fileName | String | 铃声名称。 |
来电静音模式：您可以通过 enableMuteMode 设置静音模式。
enableMuteMode
import 'package:tencent_calls_uikit/tencent_calls_uikit.dart';......void _setCallingBell() {TUICallKit.instance.enableMuteMode(true);}
详情：开启后，收到通话请求，不会播放来电铃声。
自定义离线推送铃声：请参考以下针对 iOS 和 Android 的具体设置方法。
FCM 的推送铃声为设置的应用铃声。华为、小米 和 APNS 推送铃声设置请在调用 Call 和 GroupCall 的时候设置
TUIOfflinePushInfo.iOSSound 的 iOSSound 及 androidSound 字段。VoIP 推送不支持自定义推送铃声。 APNs 推送可以修改
call和groupcall接口中的参数params中的TUIOfflinePushInfo.iOSSound设置iOS平台上的离线消息铃声。自定义您的 UI
替换图标按钮
常用图标文件名列表
图标 | 文件名称 | 说明 |
 | dialing.png | 接听来电图标 |
 | hangup.png | 挂断通话图标 |
 | mute_on.png | 关闭麦克风图标 |
 | handsfree.png | 关闭扬声器图标 |
 | camera_off.png | 关闭摄像头图标 |
 | add_user.png | 通话过程中邀请用户图标 |
常见问题
交流与反馈
如果有任何需要或者反馈，您可以联系：info_rtc@tencent.com。
文档反馈