iOS

sudo gem install cocoapods

pod init

platform :ios, '8.0'
    target 'App' do
    
    # The full feature version of SDK
    # Includes features such as RTC Engine, live streaming player (TXLivePlayer), RTMP streaming (TXLivePusher), VOD player (TXVodPlayer), and short video recording and editing (UGSV).
    pod 'TXLiteAVSDK_Professional', :podspec => 'https://liteav.sdk.qcloud.com/pod/liteavsdkspec/TXLiteAVSDK_Professional.podspec'
    
    # Tencent Effect SDK example of S1-07 package is as follows:
    pod 'TencentEffect_S1-07'

end

pod install

pod update

// Obtain the video rendering control for displaying the anchor's local video preview.
@property (nonatomic, strong) UIView *anchorPreviewView;
@property (nonatomic, strong) TRTCCloud *trtcCloud;

- (void)setupTRTC {
    self.trtcCloud = [TRTCCloud sharedInstance];
    self.trtcCloud.delegate = self;
    // Set video encoding parameters to determine the picture quality seen by remote users.
    TRTCVideoEncParam *encParam = [[TRTCVideoEncParam alloc] init];
    encParam.videoResolution = TRTCVideoResolution_960_540;
    encParam.videoFps = 15;
    encParam.videoBitrate = 1300;
    encParam.resMode = TRTCVideoResolutionModePortrait;
    [self.trtcCloud setVideoEncoderParam:encParam];
    
    // isFrontCamera can specify the use of front/rear camera for video capture
    [self.trtcCloud startLocalPreview:self.isFrontCamera view:self.anchorPreviewView];

    // Here you can specify the audio quality, from low to high as SPEECH/DEFAULT/MUSIC.
    [self.trtcCloud startLocalAudio:TRTCAudioQualityDefault];
}

- (void)setupRenderParams {
    TRTCRenderParams *params = [[TRTCRenderParams alloc] init];
    // Video mirror mode
    params.mirrorType = TRTCVideoMirrorTypeAuto;
    // Video fill mode
    params.fillMode = TRTCVideoFillMode_Fill;
    // Video rotation angle
    params.rotation = TRTCVideoRotation_0;
    // Set the rendering parameters for the local video.
    [self.trtcCloud setLocalRenderParams:params];

    // Set the video mirror mode for the encoder output.
    [self.trtcCloud setVideoEncoderMirror:YES];
    // Set the rotation of the video encoder output.
    [self.trtcCloud setVideoEncoderRotation:TRTCVideoRotation_0];
}

- (void)enterRoomByAnchorWithUserId:(NSString *)userId roomId:(NSString *)roomId {
    TRTCParams *params = [[TRTCParams alloc] init];
    // Take the room ID string as an example.
    params.strRoomId = roomId;
    params.userId = userId;
    // UserSig obtained from the business backend.
    params.userSig = @"userSig";
    // Replace with your SDKAppID.
    params.sdkAppId = 0;
    // Specify the anchor role.
    params.role = TRTCRoleAnchor;
    // Enter the room in an interactive live streaming scenario.
    [self.trtcCloud enterRoom:params appScene:TRTCAppSceneLIVE];
}

// Event callback for the result of entering the room.
- (void)onEnterRoom:(NSInteger)result {
    if (result > 0) {
        // result indicates the time taken (in milliseconds) to join the room.
        NSLog(@"Enter room succeed!");
    } else {
        // result indicates the error code when you fail to enter the room.
        NSLog(@"Enter room failed!");
    }
}

- (void)enterRoomByAudienceWithUserId:(NSString *)userId roomId:(NSString *)roomId {
    TRTCParams *params = [[TRTCParams alloc] init];
    // Take the room ID string as an example.
    params.strRoomId = roomId;
    params.userId = userId;
    // UserSig obtained from the business backend.
    params.userSig = @"userSig";
    // Replace with your SDKAppID.
    params.sdkAppId = 0;
    // Specify the audience role.
    params.role = TRTCRoleAudience;
    // Enter the room in an interactive live streaming scenario.
    [self.trtcCloud enterRoom:params appScene:TRTCAppSceneLIVE];
}

// Event callback for the result of entering the room.
- (void)onEnterRoom:(NSInteger)result {
    if (result > 0) {
        // result indicates the time taken (in milliseconds) to join the room.
        NSLog(@"Enter room succeed!");
    } else {
        // result indicates the error code when you fail to enter the room.
        NSLog(@"Enter room failed!");
    }
}

- (void)onUserAudioAvailable:(NSString *)userId available:(BOOL)available {
    // The remote user publishes/unpublishes their audio.
    // Under the automatic subscription mode, you do not need to do anything. The SDK will automatically play the remote user's audio.
}

- (void)onUserVideoAvailable:(NSString *)userId available:(BOOL)available {
    // The remote user publishes/unpublishes the primary video.
    if (available) {
        // Subscribe to the remote user's video stream and bind the video rendering control.
        [self.trtcCloud startRemoteView:userId streamType:TRTCVideoStreamTypeBig view:self.remoteView];
    } else {
        // Unsubscribe to the remote user's video stream and release the rendering control.
        [self.trtcCloud stopRemoteView:userId streamType:TRTCVideoStreamTypeBig];
    }
}

- (void)setupRemoteRenderParams {
    TRTCRenderParams *params = [[TRTCRenderParams alloc] init];
    // Video mirror mode
    params.mirrorType = TRTCVideoMirrorTypeAuto;
    // Video fill mode
    params.fillMode = TRTCVideoFillMode_Fill;
    // Video rotation angle
    params.rotation = TRTCVideoRotation_0;
    // Set the rendering mode for the remote video.
    [self.trtcCloud setRemoteRenderParams:@"userId" streamType:TRTCVideoStreamTypeBig params:params];
}

- (void)switchToAnchor {
    // Switched to the anchor role.
    [self.trtcCloud switchRole:TRTCRoleAnchor];
}

// Event callback for switching the role.
- (void)onSwitchRole:(TXLiteAVError)errCode errMsg:(NSString *)errMsg {
    if (errCode == ERR_NULL) {
        // Role switched successfully.
    }
}

- (void)setupTRTC {
    // Set video encoding parameters to determine the picture quality seen by remote users.
    TRTCVideoEncParam *encParam = [[TRTCVideoEncParam alloc] init];
    encParam.videoResolution = TRTCVideoResolution_480_270;
    encParam.videoFps = 15;
    encParam.videoBitrate = 550;
    encParam.resMode = TRTCVideoResolutionModePortrait;
    [self.trtcCloud setVideoEncoderParam:encParam];
 
    // isFrontCamera can specify the use of front/rear camera for video capture
    [self.trtcCloud startLocalPreview:self.isFrontCamera view:self.audiencePreviewView];
    // Here you can specify the audio quality, from low to high as SPEECH/DEFAULT/MUSIC.
    [self.trtcCloud startLocalAudio:TRTCAudioQualityDefault];
}

- (void)switchToAudience {
    // Switched to the audience role.
    [self.trtcCloud switchRole:TRTCRoleAudience];
}

// Event callback for switching the role.
- (void)onSwitchRole:(TXLiteAVError)errCode errMsg:(NSString *)errMsg {
    if (errCode == ERR_NULL) {
        // Stop camera capture and streaming.
        [self.trtcCloud stopLocalPreview];
        // Stop microphone capture and streaming.
        [self.trtcCloud stopLocalAudio];
    }
}

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

// Event callback for exiting the room.
- (void)onExitRoom:(NSInteger)reason {
    if (reason == 0) {
        NSLog(@"Proactively call exitRoom to exit the room");
    } else if (reason == 1) {
        NSLog(@"Removed from the current room by the server");
    } else if (reason == 2) {
        NSLog(@"The current room is dissolved");
    }
}

// Construct product pop-up message body
NSDictionary *msgDict = @{
    @"itemNumber": @1,   // Item number
    @"itemPrice": @199.0,// Item price
    @"itemTitle": @"xxx",// Item title
    @"itemUrl": @"xxx" // Item URL
};
NSDictionary *dataDict = @{
    @"cmd": @"item_popup_msg",
    @"msg": msgDict
};
NSError *error;
NSData *data = [NSJSONSerialization dataWithJSONObject:dataDict options:0 error:&error];

// Send custom group messages (it is recommended that product pop-up messages should be set to high priority)
[[V2TIMManager sharedInstance] sendGroupCustomMessage:data to:groupID priority:V2TIM_PRIORITY_HIGH succ:^{
    // Successfully sent product pop-up message
    // Locally rendering of product pop-up effect
} fail:^(int code, NSString *desc) {
    // Failed to send product pop-up message
}];

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",  // The priority of the message. It is recommended to set product pop-up messages to high priority
    "MsgBody": [
        {
            "MsgType": "TIMCustomElem", 
            "MsgContent": {
                // itemNumber: item number; itemPrice: item price; itemTitle: item title; itemUrl: item URL
                "Data": "{\"cmd\": \"item_popup_msg\", \"msg\": {\"itemNumber\": 1, \"itemPrice\": 199.0, \"itemTitle\": \"xxx\", \"itemUrl\": \"xxx\"}}"
            }
        }
    ]
}

// Custom group messages received.
[[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"];// Item number
                NSNumber *itemPrice = msgDict[@"itemPrice"];  // Item price
                NSString *itemTitle = msgDict[@"itemTitle"];  // Item title
                NSString *itemUrl = msgDict[@"itemUrl"];  // Item URL
                // Render product pop-up effect based on item number, item price, item title, and item URL
            }
        } else {
            NSLog(@"Parsing error: %@", error.localizedDescription);
        }
    }
}

// Construct product pop-up message body
NSDictionary *msgDict = @{
    @"itemNumber": @1,   // Item number
    @"itemPrice": @199.0,// Item price
    @"itemTitle": @"xxx",// Item title
    @"itemUrl": @"xxx" // Item URL
};
NSDictionary *dataDict = @{
    @"cmd": @"item_popup_msg",
    @"msg": msgDict
};
NSError *error;
NSData *data = [NSJSONSerialization dataWithJSONObject:dataDict options:0 error:&error];

// Send SEI information
[self.trtcCloud sendSEIMsg:data repeatCount:1];

// Set TRTC event listener
self.trtcCloud.delegate = self;

// Receive SEI messages
- (void)onRecvSEIMsg:(NSString *)userId message:(NSData *)message {
    if (message.length > 0) {
        NSError *error;
        NSDictionary *dataDict = [NSJSONSerialization JSONObjectWithData:message options:0 error:&error];
        if (!error) {
            NSString *command = dataDict[@"cmd"];
            NSDictionary *msgDict = dataDict[@"msg"];
            if ([command isEqualToString:@"item_popup_msg"]) {
                NSNumber *itemNumber = msgDict[@"itemNumber"];// Item number
                NSNumber *itemPrice = msgDict[@"itemPrice"];  // Item price
                NSString *itemTitle = msgDict[@"itemTitle"];  // Item title
                NSString *itemUrl = msgDict[@"itemUrl"];  // Item URL
                // Render product pop-up effect based on item number, item price, item title, and item URL
            }
        } else {
            NSLog(@"Parsing error: %@", error.localizedDescription);
        }
    }
}