iOS

sudo gem install cocoapods

pod init

pod install

pod update

Privacy - Microphone Usage Description,마이크 사용 목적 안내문을 함께 입력하세요

// Chat IM 콘솔에서 애플리케이션 SDKAppID를 획득합니다.
// V2TIMSDKListener의 이벤트 리스너를 추가합니다. self는 id<V2TIMSDKListener>의 구현 클래스이고 Chat SDK의 이벤트를 감지할 필요가 없는 경우 이 단계는 생략할 수 있습니다.
[[V2TIMManager sharedInstance] addIMSDKListener:self];
// Chat SDK를 초기화합니다. 이 인터페이스를 호출한 후 즉시 로그인 인터페이스를 호출할 수 있습니다.
[[V2TIMManager sharedInstance] initSDK:sdkAppID config:config];

// SDK 초기화 후 연결 상태, 로그인 티켓 만료 등 일부 이벤트가 발생할 수 있습니다
- (void)onConnecting {
    NSLog(@"Chat SDK가 텐센트 클라우드 서버에 연결 중입니다");
}

- (void)onConnectSuccess {
    NSLog(@"Chat SDK가 텐센트 클라우드 서버에 성공적으로 연결되었습니다");
}

// 이벤트 리스너의 제거
// self는 id<V2TIMSDKListener>의 구현 클래스입니다
[[V2TIMManager sharedInstance] removeIMSDKListener:self];
// SDK 초기화의 해제
[[V2TIMManager sharedInstance] unInitSDK];

// RTC Engine SDK 인스턴스의 생성(싱글톤 모드)
_trtcCloud = [TRTCCloud sharedInstance];
// 이벤트 리스너의 설정
_trtcCloud.delegate = self;

// SDK의 다양한 이벤트 알림(예: 오류 코드, 경고 코드, 오디오/비디오 상태 매개변수 등)
- (void)onError:(TXLiteAVError)errCode errMsg:(nullable NSString *)errMsg extInfo:(nullable NSDictionary *)extInfo {
    NSLog(@"%d: %@", errCode, errMsg);
}

- (void)onWarning:(TXLiteAVWarning)warningCode warningMsg:(nullable NSString *)warningMsg extInfo:(nullable NSDictionary *)extInfo {
    NSLog(@"%d: %@", warningCode, warningMsg);
}

// 이벤트 리스너의 제거
_trtcCloud.delegate = nil;
// RTC Engine SDK 인스턴스(싱글톤 모드)를 파기합니다.
[TRTCCloud destroySharedIntance];

// 로그인: userID는 사용자 자체 정의 가능하고 userSig는 단계1 참조하여 생성 및 획득합니다
[[V2TIMManager sharedInstance] login:userID userSig:userSig succ:^{
    NSLog(@"success");
} fail:^(int code, NSString *desc) {
    // 다음 오류 코드가 반환되면 UserSig가 만료되었음을 의미하므로 새로 발급된 UserSig를 사용하여 다시 로그인하십시오.
    // 1. ERR_USER_SIG_EXPIRED(6206)
    // 2. ERR_SVR_ACCOUNT_USERSIG_EXPIRED(70001)
    // 주의: 다른 오류 코드의 경우 여기에서 로그인 인터페이스를 호출하지 마십시오. Chat SDK 로그인이 무한 루프에 빠지는 것을 방지하기 위한 것입니다.
    NSLog(@"failure, code:%d, desc:%@", code, desc);
}];

// 로그아웃
[[V2TIMManager sharedInstance] logout:^{
    NSLog(@"success");
} fail:^(int code, NSString *desc) {
    NSLog(@"failure, code:%d, desc:%@", code, desc);
}];

// 그룹 생성
[[V2TIMManager sharedInstance] createGroup:GroupType_AVChatRoom groupID:groupID groupName:groupName succ:^(NSString *groupID) {
    // 그룹 생성 성공
} fail:^(int code, NSString *desc) {
    // 그룹 생성 실패
}];


// 그룹 생성 알림을 감시합니다
[[V2TIMManager sharedInstance] addGroupListener:self];
- (void)onGroupCreated:(NSString *)groupID {
    // 그룹 생성 콜백하고 groupID는 새로 생성된 그룹의 ID입니다
}

// 그룹 입장
[[V2TIMManager sharedInstance] joinGroup:groupID msg:message succ:^{
    // 그룹 가입 성공
} fail:^(int code, NSString *desc) {
    // 그룹 가입 실패
}];

// 그룹 가입 이벤트의 감시
[[V2TIMManager sharedInstance] addGroupListener:self];
- (void)onMemberEnter:(NSString *)groupID memberList:(NSArray<V2TIMGroupMemberInfo *>*)memberList {
    // 누군가 그룹에 가입했습니다
}

- (void)enterRoomWithRoomId:(NSString *)roomId userID:(NSString *)userId {
    TRTCParams *params = [[TRTCParams alloc] init];
    // 문자열 방 번호를 예로 들면 IM 그룹 번호와 일치하는 것이 좋습니다
    params.strRoomId = roomId;
    params.userId = userId;
    // 업무 백엔드에서 가져온 UserSig
    params.userSig = getUserSig(userId);
    // 손임의 SDKAppID로 교체합니다
    params.sdkAppId = SDKAppID;
    // 음성 채팅 상호 작용 시나리오에서 방에 들어가려면 사용자 역할을 지정해야 합니다
    params.role = TRTCRoleAudience;
    // 음성 채팅 인터랙티브 방 입장 시나리오를 예로 들어,
    [self.trtcCloud enterRoom:params appScene:TRTCAppSceneVoiceChatRoom];
}

// 방 입장 결과 이벤트의 콜백
- (void)onEnterRoom:(NSInteger)result {
    if (result > 0) {
        // result는 방에 임장하는 데 소요된 시간(밀리초)을 나타냅니다.
        [self toastTip:@"Enter room succeed!"];
    } else {
        // result는 방 입장 실패의 오류 코드를 나타냅니다.
        [self toastTip:@"Enter room failed!"];
    }
}

[[V2TIMManager sharedInstance] quitGroup:groupID succ:^{
    // 그룹 나가기 성공
} fail:^(int code, NSString *desc) {
    // 그룹 나가기 실패
}];

[[V2TIMManager sharedInstance] addGroupListener:self];
- (void)onMemberLeave:(NSString *)groupID member:(V2TIMGroupMemberInfo *)member {
    // 그룹 멤버 나가기의 콜백
}

- (void)exitTrtcRoom {
    self.trtcCloud = [TRTCCloud sharedInstance];
    [self.trtcCloud stopLocalAudio];
    [self.trtcCloud exitRoom];
}

// onExitRoom 콜백을 수신하여 자신의 퇴장 사유를 확인할 수 있습니다.
- (void)onExitRoom:(NSInteger)reason {
    if (reason == 0) {
        // exitRoom을 호출하여 방에서 나가기.
        NSLog(@"Exit current room by calling the 'exitRoom' api of sdk ...");
    } else if (reason == 1) {
        //서버에 의해 현재 방에서 나가게 됩니다
        NSLog(@"Kicked out of the current room by server through the restful api...");
    } else if (reason == 2) {
        // 현재 방 전체가 해체됩니다
        NSLog(@"Current room is dissolved by server through the restful api...");
    }
}

[[V2TIMManager sharedInstance] dismissGroup:groupID succ:^{
    // 그룹 해산 성공
} fail:^(int code, NSString *desc) {
    // 그룹 해산 실패
}];

[[V2TIMManager sharedInstance] addGroupListener:self];
- (void)onGroupDismissed:(NSString *)groupID opUser:(V2TIMGroupMemberInfo *)opUser {
    // 그룹 해산 콜백
}

// 청취자가 마이크 요청을 보내며 userId는 스트리머 Id이고  data는 시그널링 식별을 위한 json을 전달할 수 있습니다
- (void)sendInvitationWithUserId:(NSString *)userId data:(NSString *)data {
    [[V2TIMManager sharedInstance] invite:userId data:data onlineUserOnly:YES offlinePushInfo:nil timeout:0 succ:^{
        NSLog(@"sendInvitation success");
    } fail:^(int code, NSString *desc) {
        NSLog(@"sendInvitation error %d", code);
    }];
}

// 스트리머가 마이크 사용의 요청을 수신하며  inviteID는 해당 요청 Id이고 inviter는 요청자 ID입니다
[[V2TIMManager sharedInstance] addSignalingListener:self];
- (void)onReceiveNewInvitation:(NSString *)inviteID inviter:(NSString *)inviter groupID:(NSString *)groupID inviteeList:(NSArray<NSString *> *)inviteeList data:(NSString * __nullable)data {
    NSLog(@"received invitation: %@ from %@", inviteID, inviter);
}

// 마이크 사용의 요청을 동의합니다
- (void)acceptInvitationWithInviteID:(NSString *)inviteID data:(NSString *)data {
    [[V2TIMManager sharedInstance] accept:inviteID data:data succ:^{
        NSLog(@"acceptInvitation success");
    } fail:^(int code, NSString *desc) {
        NSLog(@"acceptInvitation error %d", code);
    }];
}

// 마이크 사용의 요청 거절합니다
- (void)rejectInvitationWithInviteID:(NSString *)inviteID data:(NSString *)data {
    [[V2TIMManager sharedInstance] reject:inviteID data:data succ:^{
        NSLog(@"rejectInvitation success");
    } fail:^(int code, NSString *desc) {
        NSLog(@"rejectInvitation error %d", code);
    }];
}

// 로컬에 저장된 전체 마이크 순위 정보의 목록
@property (nonatomic, copy) NSArray<SeatInfoModel *> *seatInfoArray;

// 마이크 요청 동의의 콜백
- (void)onInviteeAccepted:(NSString *)inviteID invitee:(NSString *)invitee data:(NSString * __nullable)data {
    NSLog(@"received accept invitation: %@ from %@", inviteID, invitee);
    NSInteger seatIndex = [self findSeatIndex:inviteID];
    [self takeSeatWithIndex:seatIndex];
}

// 청취자가 마이크를 켜서 사용하기 시작합니다
- (void)takeSeatWithIndex:(NSInteger)seatIndex {
    // 마이크 순위 정보 인스턴스 생성하며 수정된 마이크 순위 정보를 저장합니다
    SeatInfoModel *localInfo = self.seatInfoArray[seatIndex];
    SeatInfoModel *seatInfo = [[SeatInfoModel alloc] init];
    seatInfo.status = SeatInfoStatusUsed;
    seatInfo.mute = localInfo.mute;
    seatInfo.userId = self.userId;
    
    // 마이크 순위 정보 객체를 JSON 형식으로 직렬화합니다
    NSString *jsonStr = seatInfo.toJSONString;
    NSDictionary *dict = @{ [NSString stringWithFormat:@"seat%ld", seatIndex]: jsonStr };
    
    // 그룹 속성을 설정하고 해당 그룹 속성이 이미 있으면 value 값을 업데이트하고, 없으면 해당 속성을 추가합니다.
    [[V2TIMManager sharedInstance] setGroupAttributes:self.groupId attributes:dict succ:^{
        // 그룹 속성의 수정이 성공되고 TRTC 역할의 전환 및 스트리밍 시작합니다
        [self.trtcCloud switchRole:TRTCRoleAnchor];
        [self.trtcCloud startLocalAudio:TRTCAudioQualityDefault];
    } fail:^(int code, NSString *desc) {
        // 그룹 속성의 수정이 실패되고 마이크 연결이 실패됩니다
    }];
}

// 로컬에 저장된 전체 마이크 순위 정보의 목록
@property (nonatomic, copy) NSArray<SeatInfoModel *> *seatInfoArray;

// 스트리머 측에서 해당 인터페이스를 호출하여 그룹 속성에 저장된 마이크 순위 정보를 수정합니다.
- (void)pickSeatWithUserId:(NSString *)userId seatIndex:(NSInteger)seatIndex {
    // 마이크 순위 정보 인스턴스 생성하며 수정된 마이크 순위 정보를 저장합니다
    SeatInfoModel *localInfo = self.seatInfoArray[seatIndex];
    SeatInfoModel *seatInfo = [[SeatInfoModel alloc] init];
    seatInfo.status = SeatInfoStatusUsed;
    seatInfo.mute = localInfo.mute;
    seatInfo.userId = self.userId;
    
    // 마이크 순위 정보 객체를 JSON 형식으로 직렬화합니다
    NSString *jsonStr = seatInfo.toJSONString;
    NSDictionary *dict = @{ [NSString stringWithFormat:@"seat%ld", seatIndex]: jsonStr };
    
    // 그룹 속성 설정합니다.해당 그룹 속성이 이미 있으면 value 값을 업데이트하고 없으면 해당 속성을 추가합니다
    [[V2TIMManager sharedInstance] setGroupAttributes:self.groupId attributes:dict succ:^{
        // 그룹 속성의 수정이 성공되고 onGroupAttributeChanged 콜백 트리거됩니다
    } fail:^(int code, NSString *desc) {
        // 그룹 속성의 수정이 실패되며 마이크 연결이 실패됩니다
    }];
}

// 청취자 측에서 그룹 속성 변경 콜백을 수신하여 자체 정보에 매칭 성공 후 스트리밍 시작합니다
[[V2TIMManager sharedInstance] addGroupListener:self];
- (void)onGroupAttributeChanged:(NSString *)groupID attributes:(NSMutableDictionary<NSString *,NSString *> *)attributes {
    // 로컬에 저장된 기존의 전체 마이크 순위 정보 리스트
    NSArray *oldSeatArray = self.seatInfoArray;
    // groupAttributeMap에서 파싱한 최신 전체 마이크 순위 정보 리스트
    NSArray *newSeatArray = [self getSeatListFromAttr:attributes seatSize:self.seatSize];
    // 전체 마이크 순위 정보 리스트를 순회하며 새/구 마이크 정보를 비교합니다.
    for (int i = 0; i < self.seatSize; i++) {
        SeatInfoModel *oldInfo = oldSeatArray[i];
        SeatInfoModel *newInfo = newSeatArray[i];
        if (oldInfo.status != newInfo.status && newInfo.status == SeatInfoStatusUsed) {
            if ([newInfo.userId isEqualToString:self.userId]) {
                // 자신의 정보에 매칭 성공 후, RTC Engine 역할 전환 및 스트리밍 시작합니다
                [self.trtcCloud switchRole:TRTCRoleAnchor];
                [self.trtcCloud startLocalAudio:TRTCAudioQualityDefault];
            } else {
                // 로컬 마이크 순위 목록을 업데이트하고 로컬 마이크 순위 뷰 렌더링합니다
            }
        }
    }
}

// 로컬에 저장된 전체 마이크 순위 정보의 목록
@property (nonatomic, copy) NSArray<SeatInfoModel *> *seatInfoArray;

- (void)leaveSeatWithIndex:(NSInteger)seatIndex {
    // 마이크 순위 정보 인스턴스 생성하며 수정된 마이크 순위 정보를 저장합니다
    SeatInfoModel *localInfo = self.seatInfoArray[seatIndex];
    SeatInfoModel *seatInfo = [[SeatInfoModel alloc] init];
    seatInfo.status = SeatInfoStatusUnused;
    seatInfo.mute = localInfo.mute;
    seatInfo.userId = @"";
    
    // 마이크 순위 정보 객체를 JSON 형식으로 직렬화합니다
    NSString *jsonStr = seatInfo.toJSONString;
    NSDictionary *dict = @{ [NSString stringWithFormat:@"seat%ld", seatIndex]: jsonStr };
    
    // 그룹 속성 설정합니다.해당 그룹 속성이 이미 있으면 value 값을 업데이트하고 없으면 해당 속성을 추가합니다
    [[V2TIMManager sharedInstance] setGroupAttributes:self.groupId attributes:dict succ:^{
        // 그룹 속성의 수정이 성공되고 RTC Engine 역할 전환 및 스트리밍 중지합니다
        [self.trtcCloud switchRole:TRTCRoleAudience];
        [self.trtcCloud stopLocalAudio];
    } fail:^(int code, NSString *desc) {
        // 그룹 속성의 수정이 실패되고 마이크 끄기가 실패됩니다
    }];
}

// 로컬에 저장된 전체 마이크 순위 정보의 목록
@property (nonatomic, copy) NSArray<SeatInfoModel *> *seatInfoArray;

// 스트리머 측에서 해당 인터페이스를 호출하여 그룹 속성에 저장된 마이크 순위 정보를 수정합니다.
- (void)kickSeatWithIndex:(NSInteger)seatIndex {
    // 마이크 순위 정보 인스턴스 생성하며 수정된 마이크 순위 정보를 저장합니다
    SeatInfoModel *localInfo = self.seatInfoArray[seatIndex];
    SeatInfoModel *seatInfo = [[SeatInfoModel alloc] init];
    seatInfo.status = SeatInfoStatusUnused;
    seatInfo.mute = localInfo.mute;
    seatInfo.userId = @"";
    
    // 마이크 순위 정보 객체를 JSON 형식으로 직렬화합니다
    NSString *jsonStr = seatInfo.toJSONString;
    NSDictionary *dict = @{ [NSString stringWithFormat:@"seat%ld", seatIndex]: jsonStr };
    
    // 그룹 속성 설정합니다.해당 그룹 속성이 이미 있으면 value 값을 업데이트하고 없으면 해당 속성을 추가합니다
    [[V2TIMManager sharedInstance] setGroupAttributes:self.groupId attributes:dict succ:^{
        // 그룹 속성의 수정이 성공되고 onGroupAttributeChanged 콜백 트리거됩니다
    } fail:^(int code, NSString *desc) {
        // 그룹 속성의 수정이 실패되고 마이크  끄기 실패됩니다
    }];
}

// 연결된 청취자 측에서 그룹 속성 변경 콜백을 수신하여 자체 정보에 매칭 성공 후 스트리밍 중지합니다
[[V2TIMManager sharedInstance] addGroupListener:self];
- (void)onGroupAttributeChanged:(NSString *)groupID attributes:(NSMutableDictionary<NSString *,NSString *> *)attributes {
    // 로컬에 저장된 기존의 전체 마이크 순위 정보 리스트
    NSArray *oldSeatArray = self.seatInfoArray;
    // groupAttributeMap에서 파싱한 최신 전체 마이크 순위 정보 리스트
    NSArray *newSeatArray = [self getSeatListFromAttr:attributes seatSize:self.seatSize];
    // 전체 마이크 순위 정보 리스트를 순회하며 새/구 마이크 정보를 비교합니다.
    for (int i = 0; i < self.seatSize; i++) {
        SeatInfoModel *oldInfo = oldSeatArray[i];
        SeatInfoModel *newInfo = newSeatArray[i];
        if (oldInfo.status != newInfo.status && newInfo.status == SeatInfoStatusUnused) {
            if ([newInfo.userId isEqualToString:self.userId]) {
                // 자신의 정보에 매칭 성공 후 RTC Engine 역할을 전환하고 스트리밍을 중지합니다.
                [self.trtcCloud switchRole:TRTCRoleAudience];
                [self.trtcCloud stopLocalAudio];
            } else {
                // 로컬 마이크 순위 목록을 업데이트하고 로컬 마이크 순위 뷰 렌더링합니다
            }
        }
    }
}