iOS

sudo gem install cocoapods

pod init

pod install

pod update

Privacy - Microphone Usage Description, 、そしてマイク使用目的も入力してください。

// 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];

// ログアウト
[[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];
    // 文字列のルーム番号を例にしています。Chatのグループ番号と一致させることをお勧めします。
    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]) {
                // 自身情報のマッチングに成功、TRTCのロールに切り替えてプッシュを開始
                [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:^{
        // グループ属性の変更に成功、TRTCのロールに切り替えプッシュを停止
        [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]) {
                // 自身情報のマッチングに成功、TRTCのロールに切り替えプッシュを停止
                [self.trtcCloud switchRole:TRTCRoleAudience];
                [self.trtcCloud stopLocalAudio];
            } else {
                // ローカルマイクリストを更新し、ローカルマイクのビューをレンダリング
            }
        }
    }
}