tencent cloud

文档反馈

集成 TUILiveRoom (iOS)

最后更新时间:2022-08-15 11:49:41

    组件介绍

    TUILiveRoom 是一个开源的视频直播 UI 组件,通过在项目中集成 TUILiveRoom 组件,您只需要编写几行代码就可以为您的 App 添加“视频互动直播”场景。TUILiveRoom包含 Android、iOS、小程序等平台的源代码,基本功能如下图所示:

    说明:

    TUIKit 系列组件同时使用了腾讯云 实时音视频 TRTC即时通信 IM 两个基础 PaaS 服务,开通实时音视频后会同步开通即时通信IM服务。即时通信 IM 服务详细计费规则请参见 即时通信 - 价格说明,TRTC 开通会默认关联开通 IM SDK 的体验版,仅支持100个 DAU。

    组件集成

    步骤一:导入 TUILiveRoom 组件

    通过 cocoapods 导入组件,具体步骤如下:

    1. 在您的工程 Podfile 文件同一级目录下创建 TUILiveRoom 文件夹。
    2. 单击进入 Github/TUILiveRoom ,选择克隆/下载代码,然后将 TUILiveRoom/iOS/ 目录下的 SourceResourcesTUIBeautyTUIAudioEffectTUIBarrageTUIGiftTXAppBasic文件夹 和 TUILiveRoom.podspec 文件拷贝到您在 步骤1 创建的 TUILiveRoom 文件夹下。
    3. 在您的 Podfile 文件中添加以下依赖,之后执行 pod install 命令,完成导入。
      # :path => "指向TUILiveRoom.podspec的相对路径"
      pod 'TUILiveRoom', :path => "./TUILiveRoom/TUILiveRoom.podspec", :subspecs => ["TRTC"]
      # :path => "指向TXAppBasic.podspec的相对路径"
      pod 'TXAppBasic', :path => "./TUILiveRoom/TXAppBasic/"
      # :path => "指向TUIBeauty.podspec的相对路径"
      pod 'TUIBeauty', :path => "./TUILiveRoom/TUIBeauty/"
      # :path => "指向TUIAudioEffect.podspec的相对路径"
      pod 'TUIAudioEffect', :path => "./TUILiveRoom/TUIAudioEffect/"
      # :path => "指向TUIBarrage.podspec的相对路径"
      pod 'TUIBarrage', :path => "./TUILiveRoom/TUIBarrage/"
      # :path => "指向TUIGift.podspec的相对路径"
      pod 'TUIGift', :path => "./TUILiveRoom/TUIGift/"
      
    注意:

    • SourceResources 文件夹 和 TUILiveRoom.podspec 文件必需在同一目录下。
    • TXAppBasic.podspec 在 TXAppBasic 文件夹下。

    步骤二:配置权限

    使用音视频功能,需要授权麦克风和摄像头的使用权限。在 App 的 Info.plist 中添加以下两项,分别对应麦克风和摄像头在系统弹出授权对话框时的提示信息。

    <key>NSCameraUsageDescription</key>
    <string>RoomApp需要访问您的相机权限,开启后录制的视频才会有画面</string>
    <key>NSMicrophoneUsageDescription</key>
    <string>RoomApp需要访问您的麦克风权限,开启后录制的视频才会有声音</string>
    

    步骤三:初始化并登录组件

    @import TUILiveRoom;
    @import TUICore;

    // 1.组件登录
    [TUILogin login:@"您的SDKAppID" userID:@"您的UserID" userSig:@"您的UserSig" succ:^{

    } fail:^(int code, NSString *msg) {

    }];
    // 2.初始化TUILiveRoom实例
    TUILiveRoom *mLiveRoom = [TUILiveRoom sharedInstance];
    <dx-code-holder data-codeindex="2"></dx-code-holder>

    参数说明

    • SDKAppIDTRTC 应用 ID,如果您未开通腾讯云 TRTC 服务,可进入 腾讯云实时音视频控制台,创建一个新的 TRTC 应用后,单击应用信息,SDKAppID 信息如下图所示:
    • SecretKeyTRTC 应用密钥,和 SDKAppID 对应,进入 TRTC 应用管理 后,SecretKey 信息如上图所示。
    • UserID:当前用户的 ID,字符串类型,长度不超过32字节,不支持使用特殊字符,建议使用英文或数字,可结合业务实际账号体系自行设置。
    • UserSig:根据 SDKAppId、UserID,SecretKey 等信息计算得到的安全保护签名,您可以单击 这里 直接在线生成一个调试的 UserSig,也可以参照我们的 TUILiveRoom 示例工程 自行计算,更多信息见 如何计算及使用 UserSig

    步骤四:实现视频互动直播间

    1. 主播端开播

      [mLiveRoom createRoomWithRoomId:123 roomName:@"test room" coverUrl:@""];
    2. 观众端观看

      [mLiveRoom enterRoomWithRoomId:123];
    3. 观众与主播连麦 TRTCLiveRoom#requestJoinAnchor

      // 1.观众端发起连麦请求
      [TRTCLiveRoom shareInstance].delegate = self;
      // @param mSelfUserId String 当前用户id
      NSString *mSelfUserId = @"1314";
      [[TRTCLiveRoom shareInstance] requestJoinAnchor:[NSString stringWithFormat:@"%@ 请求和你连麦", mSelfUserId] timeout:30 responseCallback:^(BOOL agreed, NSString * _Nullable reason) {
      if (agreed) {
      // 主播接受了观众的请求
      UIView *playView = [UIView new];
      [self.view addSubView:playView];
      // 观众启动预览,开启推流
      [[TRTCLiveRoom shareInstance] startCameraPreviewWithFrontCamera:YES view:playView callback:nil];
      [[TRTCLiveRoom shareInstance] startPublishWithStreamID:[NSString stringWithFormat:@"%@_stream", mSelfUserId] callback:nil];
      }
      }];

      // 2.主播端收到连麦请求
      #pragma mark - TRTCLiveRoomDelegate
      - (void)trtcLiveRoom:(TRTCLiveRoom *)trtcLiveRoom onRequestJoinAnchor:(TRTCLiveUserInfo *)user reason:(NSString *)reason {
      // 同意对方的连麦请求
      [[TRTCLiveRoom shareInstance] responseJoinAnchor:user.userId agree:YES reason:@"同意连麦"];
      }

      - (void)trtcLiveRoom:(TRTCLiveRoom *)trtcLiveRoom onAnchorEnter:(NSString *)userID {
      // 主播收到连麦观众的上麦通知
      UIView *playView = [UIView new];
      [self.view addSubview:playView];
      // 主播播放观众画面
      [[TRTCLiveRoom shareInstance] startPlayWithUserID:userID view:playView callback:nil];
      }
    4. 主播与主播 PK TRTCLiveRoom#requestRoomPK

      // 主播 A 创建12345的房间
      [[TUILiveRoom sharedInstance] createRoomWithRoomId:12345 roomName:@"roomA" coverUrl:@"roomA coverUrl"];
      // 主播 B 创建54321的房间
      [[TUILiveRoom sharedInstance] createRoomWithRoomId:54321 roomName:@"roomB" coverUrl:@"roomB coverUrl"];

      // 主播 A
      // 主播 A 向 主播 B 发起PK请求
      [[TRTCLiveRoom shareInstance] requestRoomPKWithRoomID:543321 userID:@"roomB userId" timeout:30 responseCallback:^(BOOL agreed, NSString * _Nullable reason) {
      if (agreed) {
      // 用户B接受
      } else {
      // 用户B拒绝
      }
      }];

      // 主播 B:
      // 2.主播 B 收到主播 A 的消息
      #pragma mark - TRTCLiveRoomDelegate
      - (void)trtcLiveRoom:(TRTCLiveRoom *)trtcLiveRoom onRequestRoomPK:(TRTCLiveUserInfo *)user {
      // 3.主播 B 回复主播 A 接受请求
      [[TRTCLiveRoom shareInstance] responseRoomPKWithUserID:user.userId agree:YES reason:@""];
      }

      - (void)trtcLiveRoom:(TRTCLiveRoom *)trtcLiveRoom onAnchorEnter:(NSString *)userID {
      // 4.主播 B 收到主播 A 进房的通知,播放主播 A 的画面
      [[TRTCLiveRoom shareInstance] startPlayWithUserID:userID view:playAView callback:nil];
      }

    常见问题

    如果有任何需要或者反馈,您可以联系:colleenyu@tencent.com。

    联系我们

    联系我们,为您的业务提供专属服务。

    技术支持

    如果你想寻求进一步的帮助,通过工单与我们进行联络。我们提供7x24的工单服务。

    7x24 电话支持