tencent cloud

sudo gem install cocoapods

pod init

platform :ios, '8.0'
target 'App' do

    # TRTC Lite Edition
    # The installation package has the minimum incremental size. It only supports two features of Tencent Real-Time Communication (TRTC) and TXLivePlayer for live streaming playback.
    pod 'TXLiteAVSDK_TRTC', :podspec => 'https://liteav.sdk.qcloud.com/pod/liteavsdkspec/TXLiteAVSDK_TRTC.podspec'
    
    # Add the IM SDK
    pod 'TXIMSDK_Plus_iOS'
    # pod 'TXIMSDK_Plus_iOS_XCFramework'
    # pod 'TXIMSDK_Plus_Swift_iOS_XCFramework'
    
    # If you need to add the Quic plugin, please uncomment the next line.
    # Note: This plugin must be used with the Objective-C edition or XCFramework edition of the IM SDK, and the plugin version number must match the IM SDK version number.
    # pod 'TXIMSDK_Plus_QuicPlugin'

end

pod install

pod update

Privacy - Microphone Usage Description. Also enter a prompt specifying the purpose of microphone use.

// Obtain the SDKAppID from the Instant Messaging (IM) console.
// Add a V2TIMSDKListener event listener. self is the implementation class of id <V2TIMSDKListener>. This step can be skipped if you do not need to listen for events from the IM SDK.
[[V2TIMManager sharedInstance] addIMSDKListener:self];
// Initialize the IM SDK. After calling this API, you can immediately call the log-in API.
[[V2TIMManager sharedInstance] initSDK:sdkAppID config:config];

// After the SDK is initialized, it will trigger various events, such as connection status and expiration of log-in credentials.
- (void)onConnecting {
    NSLog(@"The IM SDK is connecting to Tencent Cloud CVM.");
}

- (void)onConnectSuccess {
    NSLog(@"The IM SDK has successfully connected to Tencent Cloud CVM.");
}

// Remove event listener.
// self is the implementation class of id <V2TIMSDKListener>.
[[V2TIMManager sharedInstance] removeIMSDKListener:self];
// Deinitialize the SDK.
[[V2TIMManager sharedInstance] unInitSDK];

// Create TRTC SDK instance (Single Instance Pattern).
_trtcCloud = [TRTCCloud sharedInstance];
// Set event listeners.
_trtcCloud.delegate = self;

// Notifications from various SDK events (e.g., error codes, warning codes, audio and video status parameters, etc.).
- (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);
}

// Remove event listener.
_trtcCloud.delegate = nil;
// Terminate TRTC SDK instance (Singleton Pattern).
[TRTCCloud destroySharedIntance];

// Log in: userID can be defined by the user and userSig can be generated as per Step 1.
[[V2TIMManager sharedInstance] login:userID userSig:userSig succ:^{
    NSLog(@"success");
} fail:^(int code, NSString *desc) {
    // The following error codes mean an expired UserSig, and you need to generate a new one for log-in again.
    // 1. ERR_USER_SIG_EXPIRED(6206).
    // 2. ERR_SVR_ACCOUNT_USERSIG_EXPIRED(70001).
    // Note: Do not call the log-in API in case of other error codes. Otherwise, the IM SDK may enter an infinite loop of log-in.
    NSLog(@"failure, code:%d, desc:%@", code, desc);
}];

// Log out.
[[V2TIMManager sharedInstance] logout:^{
    NSLog(@"success");
} fail:^(int code, NSString *desc) {
    NSLog(@"failure, code:%d, desc:%@", code, desc);
}];

// Create a group.
[[V2TIMManager sharedInstance] createGroup:GroupType_AVChatRoom groupID:groupID groupName:groupName succ:^(NSString *groupID) {
    // Group created successfully.
} fail:^(int code, NSString *desc) {
    // Group creation failed.
}];


// Listen for group creation notifications.
[[V2TIMManager sharedInstance] addGroupListener:self];
- (void)onGroupCreated:(NSString *)groupID {
    // Group creation callback. groupID is the ID of the newly created group.
}

// Join a group.
[[V2TIMManager sharedInstance] joinGroup:groupID msg:message succ:^{
    // Successfully joined the group.
} fail:^(int code, NSString *desc) {
    // Failed to join the group.
}];

// Listen for the event of joining a group.
[[V2TIMManager sharedInstance] addGroupListener:self];
- (void)onMemberEnter:(NSString *)groupID memberList:(NSArray<V2TIMGroupMemberInfo *>*)memberList {
    // Someone joined the group.
}

- (void)enterRoomWithRoomId:(NSString *)roomId userID:(NSString *)userId {
    TRTCParams *params = [[TRTCParams alloc] init];
    // Using a string as the room ID for example, it is recommended to keep it consistent with the IM group ID.
    params.strRoomId = roomId;
    params.userId = userId;
    // UserSig obtained from the business backend.
    params.userSig = getUserSig(userId);
    // Replace with your SDKAppID.
    params.sdkAppId = SDKAppID;
    // For entering a room in voice chat interaction scenarios, specify the user's role.
    params.role = TRTCRoleAudience;
    // Use room entry in voice chat interaction scenarios as an example.
    [self.trtcCloud enterRoom:params appScene:TRTCAppSceneVoiceChatRoom];
}

// 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.
        [self toastTip:@"Enter room succeed!"];
    } else {
        // result indicates the error code when you fail to enter the room.
        [self toastTip:@"Enter room failed!"];
    }
}

[[V2TIMManager sharedInstance] quitGroup:groupID succ:^{
    // Exiting the group successful.
} fail:^(int code, NSString *desc) {
    // Exiting the group failed.
}];

[[V2TIMManager sharedInstance] addGroupListener:self];
- (void)onMemberLeave:(NSString *)groupID member:(V2TIMGroupMemberInfo *)member {
    // Group member leave callback.
}

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

// Listen for the onExitRoom callback to get the reason for exiting the room.
- (void)onExitRoom:(NSInteger)reason {
    if (reason == 0) {
        // Actively call exitRoom to exit the room.
        NSLog(@"Exit current room by calling the 'exitRoom' api of sdk ...");
    } else if (reason == 1) {
        // Removed from the current room by the server.
        NSLog(@"Kicked out of the current room by server through the restful api...");
    } else if (reason == 2) {
        // The current room is dissolved.
        NSLog(@"Current room is dissolved by server through the restful api...");
    }
}

[[V2TIMManager sharedInstance] dismissGroup:groupID succ:^{
    // Dissolving group successful.
} fail:^(int code, NSString *desc) {
    // Dissolving the group failed.
}];

[[V2TIMManager sharedInstance] addGroupListener:self];
- (void)onGroupDismissed:(NSString *)groupID opUser:(V2TIMGroupMemberInfo *)opUser {
    // Group dissolved callback.
}

#import "JSONModel.h"

typedef NS_ENUM(NSUInteger, SeatInfoStatus) {
    SeatInfoStatusUnused = 0,
    SeatInfoStatusUsed = 1,
    SeatInfoStatusLocked = 2,
};

NS_ASSUME_NONNULL_BEGIN

@interface SeatInfoModel : JSONModel

/// Seat status, corresponding to three statuses.
@property (nonatomic, assign) SeatInfoStatus status;
/// Whether the seat is muted.
@property (nonatomic, assign) BOOL mute;
/// When the seat is occupied, store the user information.
@property (nonatomic, copy) NSString *userId;

@end

NS_ASSUME_NONNULL_END

// Audience sends a request to speak. userId is the Anchor ID, and data can pass in a JSON identifying the signaling.
- (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);
    }];
}

// Anchor receives the request to speak. inviteID is the request ID, and inviter is the requester 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);
}

// Agree to the request to speak.
- (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);
    }];
}

// Reject the request to speak.
- (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);
    }];
}

// Locally saved full list of seats.
@property (nonatomic, copy) NSArray<SeatInfoModel *> *seatInfoArray;

// Callback for agreeing to the request to speak.
- (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];
}

// Audience begins to speak.
- (void)takeSeatWithIndex:(NSInteger)seatIndex {
    // Create a seat information instance. Store the modified seat information.
    SeatInfoModel *localInfo = self.seatInfoArray[seatIndex];
    SeatInfoModel *seatInfo = [[SeatInfoModel alloc] init];
    seatInfo.status = SeatInfoStatusUsed;
    seatInfo.mute = localInfo.mute;
    seatInfo.userId = self.userId;
    
    // Serialize the seat information object into JSON format.
    NSString *jsonStr = seatInfo.toJSONString;
    NSDictionary *dict = @{ [NSString stringWithFormat:@"seat%ld", seatIndex]: jsonStr };
    
    // Set group attributes. If the group attribute already exists, its value is updated. Otherwise, the attribute is added.
    [[V2TIMManager sharedInstance] setGroupAttributes:self.groupId attributes:dict succ:^{
        // Successfully modified group attributes. Switch TRTC role and start streaming.
        [self.trtcCloud switchRole:TRTCRoleAnchor];
        [self.trtcCloud startLocalAudio:TRTCAudioQualityDefault];
    } fail:^(int code, NSString *desc) {
        // Failed to modify group attributes. Failed to become a speaker.
    }];
}

// Locally saved full list of seats.
@property (nonatomic, copy) NSArray<SeatInfoModel *> *seatInfoArray;

// Anchor calls this API to modify the seat information saved in group attributes.
- (void)pickSeatWithUserId:(NSString *)userId seatIndex:(NSInteger)seatIndex {
    // Create a seat information instance. Store the modified seat information.
    SeatInfoModel *localInfo = self.seatInfoArray[seatIndex];
    SeatInfoModel *seatInfo = [[SeatInfoModel alloc] init];
    seatInfo.status = SeatInfoStatusUsed;
    seatInfo.mute = localInfo.mute;
    seatInfo.userId = self.userId;
    
    // Serialize the seat information object into JSON format.
    NSString *jsonStr = seatInfo.toJSONString;
    NSDictionary *dict = @{ [NSString stringWithFormat:@"seat%ld", seatIndex]: jsonStr };
    
    // Set group attributes. If the group attribute already exists, its value is updated. Otherwise, the attribute is added.
    [[V2TIMManager sharedInstance] setGroupAttributes:self.groupId attributes:dict succ:^{
        // Successfully modified group attributes and it triggers onGroupAttributeChanged callback.
    } fail:^(int code, NSString *desc) {
        // Failed to modify group attributes. Failed to become a speaker.
    }];
}

// Audience receives group attribute change callback. Audience starts streaming after successfully matching own information.
[[V2TIMManager sharedInstance] addGroupListener:self];
- (void)onGroupAttributeChanged:(NSString *)groupID attributes:(NSMutableDictionary<NSString *,NSString *> *)attributes {
    // Last locally saved full list of seats.
    NSArray *oldSeatArray = self.seatInfoArray;
    // The most recent full list of seats parsed from groupAttributeMap.
    NSArray *newSeatArray = [self getSeatListFromAttr:attributes seatSize:self.seatSize];
    // Iterate through the full list of seats. Compare old and new seat information.
    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]) {
                // Match own information successfully. Switch TRTC role and start streaming.
                [self.trtcCloud switchRole:TRTCRoleAnchor];
                [self.trtcCloud startLocalAudio:TRTCAudioQualityDefault];
            } else {
                // Update local seat list. Render local seat view.
            }
        }
    }
}

// Locally saved full list of seats.
@property (nonatomic, copy) NSArray<SeatInfoModel *> *seatInfoArray;

- (void)leaveSeatWithIndex:(NSInteger)seatIndex {
    // Create a seat information instance. Store the modified seat information.
    SeatInfoModel *localInfo = self.seatInfoArray[seatIndex];
    SeatInfoModel *seatInfo = [[SeatInfoModel alloc] init];
    seatInfo.status = SeatInfoStatusUnused;
    seatInfo.mute = localInfo.mute;
    seatInfo.userId = @"";
    
    // Serialize the seat information object into JSON format.
    NSString *jsonStr = seatInfo.toJSONString;
    NSDictionary *dict = @{ [NSString stringWithFormat:@"seat%ld", seatIndex]: jsonStr };
    
    // Set group attributes. If the group attribute already exists, its value is updated. Otherwise, the attribute is added.
    [[V2TIMManager sharedInstance] setGroupAttributes:self.groupId attributes:dict succ:^{
        // Successfully modified group attributes. Switch TRTC role and stop streaming.
        [self.trtcCloud switchRole:TRTCRoleAudience];
        [self.trtcCloud stopLocalAudio];
    } fail:^(int code, NSString *desc) {
        // Failed to modify group attributes. Failed to become a listener.
    }];
}

// Locally saved full list of seats.
@property (nonatomic, copy) NSArray<SeatInfoModel *> *seatInfoArray;

// Anchor calls this API to modify the seat information saved in group attributes.
- (void)kickSeatWithIndex:(NSInteger)seatIndex {
    // Create a seat information instance. Store the modified seat information.
    SeatInfoModel *localInfo = self.seatInfoArray[seatIndex];
    SeatInfoModel *seatInfo = [[SeatInfoModel alloc] init];
    seatInfo.status = SeatInfoStatusUnused;
    seatInfo.mute = localInfo.mute;
    seatInfo.userId = @"";
    
    // Serialize the seat information object into JSON format.
    NSString *jsonStr = seatInfo.toJSONString;
    NSDictionary *dict = @{ [NSString stringWithFormat:@"seat%ld", seatIndex]: jsonStr };
    
    // Set group attributes. If the group attribute already exists, its value is updated. Otherwise, the attribute is added.
    [[V2TIMManager sharedInstance] setGroupAttributes:self.groupId attributes:dict succ:^{
        // Successfully modified group attributes and it triggers onGroupAttributeChanged callback.
    } fail:^(int code, NSString *desc) {
        // Failed to modify group attributes. Failed to remove the speaker.
    }];
}

// Mic-connecting audience receives group attribute change callback. It stops streaming after successfully matching own information.
[[V2TIMManager sharedInstance] addGroupListener:self];
- (void)onGroupAttributeChanged:(NSString *)groupID attributes:(NSMutableDictionary<NSString *,NSString *> *)attributes {
    // Last locally saved full list of seats.
    NSArray *oldSeatArray = self.seatInfoArray;
    // The most recent full list of seats parsed from groupAttributeMap.
    NSArray *newSeatArray = [self getSeatListFromAttr:attributes seatSize:self.seatSize];
    // Iterate through the full list of seats. Compare old and new seat information.
    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]) {
                // Match own information successfully. Switch TRTC role and stop streaming.
                [self.trtcCloud switchRole:TRTCRoleAudience];
                [self.trtcCloud stopLocalAudio];
            } else {
                // Update local seat list. Render local seat view.
            }
        }
    }
}