TUIRoom 是一个开源的音视频 UI 组件,通过在项目中集成 TUIRoom 组件,您只需要编写几行代码就可以为您的 App 添加屏幕分享、美颜、低延时视频通话等。TUIRoom 同时支持 Android、Windows,Mac 等平台,基本功能如下图所示:
说明:TUIKit 系列组件同时使用了腾讯云 实时音视频 TRTC 和 即时通信 IM 两个基础 PaaS 服务,开通实时音视频后会同步开通即时通信IM服务。即时通信 IM 服务详细计费规则请参见 即时通信 - 价格说明,TRTC 开通会默认关联开通 IM SDK 的体验版,仅支持100个 DAU。
通过 cocoapods 导入组件,具体步骤如下:
Podfile
文件同一级目录下创建 TUIRoom
文件夹。Source
、Resources
、TUIBeauty
、TXAppBasic
文件夹 和 TUIRoom.podspec
文件拷贝到您在 步骤1
创建的 TUIRoom 文件夹下。pod install
命令,完成导入。# :path => "指向TUIRoom.podspec的相对路径"
pod 'TUIRoom', :path => "./TUIRoom/TUIRoom.podspec", :subspecs => ["TRTC"]
# :path => "指向TXAppBasic.podspec的相对路径"
pod 'TXAppBasic', :path => "./TUIRoom/TXAppBasic/"
# :path => "指向TUIBeauty.podspec的相对路径"
pod 'TUIBeauty', :path => "./TUIRoom/TUIBeauty/"
注意:
Source
、Resources
文件夹 和TUIRoom.podspec
文件必需在同一目录下。
- TXAppBasic.podspec 在 TXAppBasic 文件夹下。
- TUIBeauty.podspec 在 TCBeautyKit 文件夹下。
使用音视频功能,需要授权麦克风和摄像头的使用权限。在 App 的 Info.plist 中添加以下两项,分别对应麦克风和摄像头在系统弹出授权对话框时的提示信息。
<key>NSCameraUsageDescription</key>
<string>RoomApp需要访问您的相机权限,开启后录制的视频才会有画面</string>
<key>NSMicrophoneUsageDescription</key>
<string>RoomApp需要访问您的麦克风权限,开启后录制的视频才会有声音</string>
@import TUIRoom;
@import TUICore;
// 1.组件登录
[TUILogin login:@"您的SDKAppID" userID:@"您的UserID" userSig:@"您的UserSig" succ:^{
} fail:^(int code, NSString *msg) {
}];
// 2.初始化TUIRoom实例
TUIRoom *tuiRoom = [TUIRoom sharedInstance];
<dx-code-holder data-codeindex="2"></dx-code-holder>
参数说明:
@import TUIRoom;
[tuiRoom createRoomWithRoomId:12345 speechMode:TUIRoomFreeSpeech isOpenCamera:YES isOpenMicrophone:YES];
@import TUIRoom;
[[TUIRoomCore shareInstance] destroyRoom:^(NSInteger code, NSString * _Nonnull message) {
}];
<dx-code-holder data-codeindex="4"></dx-code-holder>
@import TUIRoom;
[[TUIRoomCore shareInstance] leaveRoom:^(NSInteger code, NSString * _Nonnull message) {
}];
<dx-code-holder data-codeindex="5"></dx-code-holder>
实现屏幕分享 TUIRoomCore#startScreenCapture。屏幕分享工程配置请参见 实时屏幕分享(iOS)。
@import TUIRoom;
@import TXLiteAVSDK_Professional;
TRTCVideoEncParam *params = [[TRTCVideoEncParam alloc] init];
params.videoResolution = TRTCVideoResolution_1280_720;
params.resMode = TRTCVideoResolutionModePortrait;
params.videoFps = 10;
params.enableAdjustRes = NO;
params.videoBitrate = 1500;
[[TUIRoomCore shareInstance] startScreenCapture:param];
<dx-code-holder data-codeindex="6"></dx-code-holder>
在终端窗口中输入如下命令(需要提前在 Mac 中安装 Ruby 环境):
:::
::: Swift Swift
import TUIRoom
import TUICore
// 1.组件登录
TUILogin.login("您的SDKAppID", userID: "您的UserID", userSig: "您的UserSig") {
} fail: { code, msg in
}
// 2.初始化TUIRoom实例
let tuiRoom = TUIRoom.sharedInstance
说明:如果有任何需要或者反馈,您可以联系:colleenyu@tencent.com。
本页内容是否解决了您的问题?