iOS

sudo gem install cocoapods

pod init

platform :ios, '8.0'
    target 'App' do
    
    # 全功能版 SDK
    # 包含实时音视频（RTC Engine）、直播播放器（TXLivePlayer）、RTMP 推流（TXLivePusher）、点播播放器（TXVodPlayer）和短视频录制和编辑（UGSV）等众多功能。
    pod 'TXLiteAVSDK_Professional', :podspec => 'https://liteav.sdk.qcloud.com/pod/liteavsdkspec/TXLiteAVSDK_Professional.podspec'
    
    # 腾讯特效 SDK 例如：S1-07套餐如下
    pod 'TencentEffect_S1-07'

end

pod install

pod update

// 获取用于展示主播本地画面预览的视频渲染控件
@property (nonatomic, strong) UIView *anchorPreviewView;
@property (nonatomic, strong) TRTCCloud *trtcCloud;

- (void)setupTRTC {
    self.trtcCloud = [TRTCCloud sharedInstance];
    self.trtcCloud.delegate = self;
    // 设置视频编码参数，决定远端用户看到的画面质量
    TRTCVideoEncParam *encParam = [[TRTCVideoEncParam alloc] init];
    encParam.videoResolution = TRTCVideoResolution_960_540;
    encParam.videoFps = 15;
    encParam.videoBitrate = 1300;
    encParam.resMode = TRTCVideoResolutionModePortrait;
    [self.trtcCloud setVideoEncoderParam:encParam];
    
    // isFrontCamera 可指定使用前置/后置摄像头进行视频采集
    [self.trtcCloud startLocalPreview:self.isFrontCamera view:self.anchorPreviewView];

    // 这里可指定声音音质，从低到高分别为 SPEECH/DEFAULT/MUSIC
    [self.trtcCloud startLocalAudio:TRTCAudioQualityDefault];
}

- (void)setupRenderParams {
    TRTCRenderParams *params = [[TRTCRenderParams alloc] init];
    // 画面镜像模式
    params.mirrorType = TRTCVideoMirrorTypeAuto;
    // 画面填充模式
    params.fillMode = TRTCVideoFillMode_Fill;
    // 画面旋转角度
    params.rotation = TRTCVideoRotation_0;
    // 设置本地画面的渲染参数
    [self.trtcCloud setLocalRenderParams:params];

    // 设置编码器输出的画面镜像模式
    [self.trtcCloud setVideoEncoderMirror:YES];
    // 设置视频编码器输出的画面方向
    [self.trtcCloud setVideoEncoderRotation:TRTCVideoRotation_0];
}

- (void)enterRoomByAnchorWithUserId:(NSString *)userId roomId:(NSString *)roomId {
    TRTCParams *params = [[TRTCParams alloc] init];
    // 以字符串房间号为例
    params.strRoomId = roomId;
    params.userId = userId;
    // 从业务后台获取到的 UserSig
    params.userSig = @"userSig";
    // 替换成您的 SDKAppID
    params.sdkAppId = 0;
    // 指定主播角色
    params.role = TRTCRoleAnchor;
    // 以互动直播场景进房
    [self.trtcCloud enterRoom:params appScene:TRTCAppSceneLIVE];
}

// 进房结果事件回调
- (void)onEnterRoom:(NSInteger)result {
    if (result > 0) {
        // result 代表加入房间所消耗的时间(毫秒)
        NSLog(@"Enter room succeed!");
    } else {
        // result 代表进房失败的错误码
        NSLog(@"Enter room failed!");
    }
}

- (void)enterRoomByAudienceWithUserId:(NSString *)userId roomId:(NSString *)roomId {
    TRTCParams *params = [[TRTCParams alloc] init];
    // 以字符串房间号为例
    params.strRoomId = roomId;
    params.userId = userId;
    // 从业务后台获取到的 UserSig
    params.userSig = @"userSig";
    // 替换成您的 SDKAppID
    params.sdkAppId = 0;
    // 指定观众角色
    params.role = TRTCRoleAudience;
    // 以互动直播场景进房
    [self.trtcCloud enterRoom:params appScene:TRTCAppSceneLIVE];
}

// 进房结果事件回调
- (void)onEnterRoom:(NSInteger)result {
    if (result > 0) {
        // result 代表加入房间所消耗的时间(毫秒)
        NSLog(@"Enter room succeed!");
    } else {
        // result 代表进房失败的错误码
        NSLog(@"Enter room failed!");
    }
}

- (void)onUserAudioAvailable:(NSString *)userId available:(BOOL)available {
    // 某远端用户发布/取消了自己的音频
    // 在自动订阅模式下，您无需做任何操作，SDK 会自动播放远端用户音频
}

- (void)onUserVideoAvailable:(NSString *)userId available:(BOOL)available {
    // 某远端用户发布/取消了主路视频画面
    if (available) {
        // 订阅远端用户的视频流，并绑定视频渲染控件
        [self.trtcCloud startRemoteView:userId streamType:TRTCVideoStreamTypeBig view:self.remoteView];
    } else {
        // 停止订阅远端用户的视频流，并释放渲染控件
        [self.trtcCloud stopRemoteView:userId streamType:TRTCVideoStreamTypeBig];
    }
}

- (void)setupRemoteRenderParams {
    TRTCRenderParams *params = [[TRTCRenderParams alloc] init];
    // 画面镜像模式
    params.mirrorType = TRTCVideoMirrorTypeAuto;
    // 画面填充模式
    params.fillMode = TRTCVideoFillMode_Fill;
    // 画面旋转角度
    params.rotation = TRTCVideoRotation_0;
    // 设置远端画面的渲染模式
    [self.trtcCloud setRemoteRenderParams:@"userId" streamType:TRTCVideoStreamTypeBig params:params];
}

- (void)switchToAnchor {
    // 切换为主播角色
    [self.trtcCloud switchRole:TRTCRoleAnchor];
}

// 切换角色事件回调
- (void)onSwitchRole:(TXLiteAVError)errCode errMsg:(NSString *)errMsg {
    if (errCode == ERR_NULL) {
        // 切换角色成功
    }
}

- (void)setupTRTC {
    // 设置视频编码参数，决定远端用户看到的画面质量
    TRTCVideoEncParam *encParam = [[TRTCVideoEncParam alloc] init];
    encParam.videoResolution = TRTCVideoResolution_480_270;
    encParam.videoFps = 15;
    encParam.videoBitrate = 550;
    encParam.resMode = TRTCVideoResolutionModePortrait;
    [self.trtcCloud setVideoEncoderParam:encParam];
 
    // isFrontCamera 可指定使用前置/后置摄像头进行视频采集
    [self.trtcCloud startLocalPreview:self.isFrontCamera view:self.audiencePreviewView];
    // 这里可指定声音音质，从低到高分别为 SPEECH/DEFAULT/MUSIC
    [self.trtcCloud startLocalAudio:TRTCAudioQualityDefault];
}

- (void)switchToAudience {
    // 切换为观众角色
    [self.trtcCloud switchRole:TRTCRoleAudience];
}

// 切换角色事件回调
- (void)onSwitchRole:(TXLiteAVError)errCode errMsg:(NSString *)errMsg {
    if (errCode == ERR_NULL) {
        // 停止摄像头采集推流
        [self.trtcCloud stopLocalPreview];
        // 停止麦克风采集推流
        [self.trtcCloud stopLocalAudio];
    }
}

- (void)exitRoom {
    [self.trtcCloud stopLocalAudio];
    [self.trtcCloud stopLocalPreview];
    [self.trtcCloud exitRoom];
}

// 离开房间事件回调
- (void)onExitRoom:(NSInteger)reason {
    if (reason == 0) {
        NSLog(@"主动调用 exitRoom 退出房间");
    } else if (reason == 1) {
        NSLog(@"被服务器踢出当前房间");
    } else if (reason == 2) {
        NSLog(@"当前房间整个被解散");
    }
}

// 构造商品弹窗消息体
NSDictionary *msgDict = @{
    @"itemNumber": @1,       // 商品编号
    @"itemPrice": @199.0,    // 商品价格
    @"itemTitle": @"xxx",    // 商品标题
    @"itemUrl": @"xxx"       // 商品图片地址
};
NSDictionary *dataDict = @{
    @"cmd": @"item_popup_msg",
    @"msg": msgDict
};
NSError *error;
NSData *data = [NSJSONSerialization dataWithJSONObject:dataDict options:0 error:&error];

// 发送群自定义消息（商品弹窗消息建议设置为高优先级）
[[V2TIMManager sharedInstance] sendGroupCustomMessage:data to:groupID priority:V2TIM_PRIORITY_HIGH succ:^{
    // 发送商品弹窗消息成功
    // 本地渲染商品弹窗效果
} fail:^(int code, NSString *desc) {
    // 发送商品弹窗消息失败
}];

https://xxxxxx/v4/group_open_http_svc/send_group_msg?sdkappid=88888888&identifier=admin&usersig=xxx&random=99999999&contenttype=json

{
    "GroupId": "@TGS#12DEVUDHQ",
    "Random": 2784275388,
    "MsgPriority": "High",  // 消息的优先级，商品弹窗消息建议设置为高优先级
    "MsgBody": [
        {
            "MsgType": "TIMCustomElem", 
            "MsgContent": {
                // itemNumber: 商品编号; itemPrice: 商品价格; itemTitel: 商品标题; itemUrl: 商品图片地址
                "Data": "{\"cmd\": \"item_popup_msg\", \"msg\": {\"itemNumber\": 1, \"itemPrice\": 199.0, \"itemTitle\": \"xxx\", \"itemUrl\": \"xxx\"}}"
            }
        }
    ]
}

// 收到群自定义消息
[[V2TIMManager sharedInstance] addSimpleMsgListener:self];
- (void)onRecvGroupCustomMessage:(NSString *)msgID groupID:(NSString *)groupID sender:(V2TIMGroupMemberInfo *)info customData:(NSData *)data {
    if (data.length > 0) {
        NSError *error;
        NSDictionary *dataDict = [NSJSONSerialization JSONObjectWithData:data options:0 error:&error];
        if (!error) {
            NSString *command = dataDict[@"cmd"];
            NSDictionary *msgDict = dataDict[@"msg"];
            if ([command isEqualToString:@"item_popup_msg"]) {
                NSNumber *itemNumber = msgDict[@"itemNumber"];    // 商品编号
                NSNumber *itemPrice = msgDict[@"itemPrice"];      // 商品价格
                NSString *itemTitle = msgDict[@"itemTitle"];      // 商品标题
                NSString *itemUrl = msgDict[@"itemUrl"];          // 商品图片地址
                // 根据商品编号、商品价格、商品标题、商品图片地址渲染商品弹窗效果
            }
        } else {
            NSLog(@"解析错误: %@", error.localizedDescription);
        }
    }
}

// 构造商品弹窗消息体
NSDictionary *msgDict = @{
    @"itemNumber": @1,       // 商品编号
    @"itemPrice": @199.0,    // 商品价格
    @"itemTitle": @"xxx",    // 商品标题
    @"itemUrl": @"xxx"       // 商品图片地址
};
NSDictionary *dataDict = @{
    @"cmd": @"item_popup_msg",
    @"msg": msgDict
};
NSError *error;
NSData *data = [NSJSONSerialization dataWithJSONObject:dataDict options:0 error:&error];

// 发送 SEI 信息
[self.trtcCloud sendSEIMsg:data repeatCount:1];