iOS

sudo gem install cocoapods

pod init

platform :ios, '8.0'
    target 'App' do
    
    # 전체 기능 버전 SDK
    # Real-Time Communication Engine (RTC Engine), 라이브방송 플레이어(TXLivePlayer), RTMP 푸시 스트리밍(TXLivePusher), VOD 플레이어(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];

// RTC Engine 이벤트 리스너의 설정
self.trtcCloud.delegate = self;

// SEI 메시지의 수신
- (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"];    // 상품 번호
                NSNumber *itemPrice = msgDict[@"itemPrice"];      // 상품 가격
                NSString *itemTitle = msgDict[@"itemTitle"];      // 상품 제목
                NSString *itemUrl = msgDict[@"itemUrl"];          // 상품 이미지 주소
                // 상품 번호, 상품 가격, 상품 제목, 상품 이미지 주소에 따라 상품 팝업 효과를 렌더링합니다
            }
        } else {
            NSLog(@"파싱 오류: %@", error.localizedDescription);
        }
    }
}