Quickstart

RTCEngineConfig *engineConfig = [[RTCEngineConfig alloc] init];
engineConfig.enableLocalLog = YES;

RTCEngineError errorCode = [[RTCEngineKit sharedEngine] initializeWithConfig:self.engineConfig appGroup:@"Application Group Identifier" delegate:self];
if (errorCode != RTCEngineErrorOK) {
    NSLog(@"Failed to initialize the RTC service");
}

@interface YourClass : NSObject <RTCEngineDelegate, RTCEngineChannelDelegate>
/// Add any of the following callbacks here as needed.

/// Join succeeded callback
/// @param channel channel instance the event comes from
/// @param userId user ID
- (void)engineChannel:(RTCEngineChannel *)channel onJoinSucceed:(NSString *)userId {
    
    NSLog(@"Joined the channel: channel = %@, userId = %@", channel.channel, userId);
}

/// Local user data updated callback
/// @param channel channel instance the event comes from
/// @param userId user ID
- (void)engineChannel:(RTCEngineChannel *)channel onUserUpdate:(NSString *)userId {
    
    NSLog(@"Local user data updated: channel = %@, userId = %@", channel.channel, userId);
}

/// Reconnecting callback
/// @param channel channel instance the event comes from
- (void)engineChannelOnReconnecting:(RTCEngineChannel *)channel {
    
    NSLog(@"Connection lost, the SDK is trying to reconnect channel = %@", channel.channel);
}

/// Reconnected callback
/// @param channel channel instance the event comes from
- (void)engineChannelOnReconnected:(RTCEngineChannel *)channel {
    
    NSLog(@"Service connected/reconnected channel = %@", channel.channel);
}

/// Disconnected callback
/// Triggered by an unrecoverable error or when you leave the channel involuntarily; you need to get a new token after this event
/// @param channel channel instance the event comes from
/// @param reason leave reason
/// @param errCode error code
/// @param errMsg error message
- (void)engineChannel:(RTCEngineChannel *)channel onDisconnected:(RTCLeaveReason)reason errCode:(RTCEngineError)errCode errMsg:(nullable NSString *)errMsg {
    
    NSLog(@"Disconnected or removed from the channel, please log in again channel = %@, reason = %ld, errCode = %ld, errMsg = %@", channel.channel, (long)reason, (long)errCode, errMsg);
}

/// Custom message callback
/// @param channel channel instance the event comes from
/// @param content message content
/// @param action message action
/// @param userId user ID
/// @param sessionId session ID
/// @param nickname user nickname
- (void)engineChannel:(RTCEngineChannel *)channel onCustomMessage:(NSString *)content action:(NSString *)action userId:(nullable NSString *)userId sessionId:(nullable NSString *)sessionId nickname:(nullable NSString *)nickname {
    
    NSLog(@"Received a custom message channel = %@, action = %@, content = %@", channel.channel, action, content);
}

/// Channel updated callback
/// @param channel channel instance the event comes from
/// @param props custom data
- (void)engineChannel:(RTCEngineChannel *)channel onChannelUpdate:(NSString *)props {
    
    NSLog(@"Channel data updated channel = %@, props = %@", channel.channel, props);
}

/// User joined callback
/// @param channel channel instance the event comes from
/// @param userId user ID
- (void)engineChannel:(RTCEngineChannel *)channel onRemoteUserJoinChannel:(NSString *)userId {
    
    NSLog(@"A user joined the channel channel = %@, userId = %@", channel.channel, userId);
}

/// User data updated callback
/// @param channel channel instance the event comes from
/// @param userId user ID
- (void)engineChannel:(RTCEngineChannel *)channel onRemoteUserUpdate:(NSString *)userId {
    
    NSLog(@"User data updated channel = %@, userId = %@", channel.channel, userId);
}

/// User left callback
/// @param channel channel instance the event comes from
/// @param userId user ID
/// @param reason leave reason
- (void)engineChannel:(RTCEngineChannel *)channel onRemoteUserLeaveChannel:(NSString *)userId reason:(RTCLeaveReason)reason {
    
    NSLog(@"A user left the channel channel = %@, userId = %@", channel.channel, userId);
}

/// User stream changed callback
/// @param channel channel instance the event comes from
/// @param userId user ID
/// @param streamTrackModel stream track data
/// @param changeType change type
- (void)engineChannel:(RTCEngineChannel *)channel onRemoteStreamTrackChange:(NSString *)userId streamTrackModel:(RTCEngineStreamTrackModel *)streamTrackModel changeType:(RTCChangeType)changeType {
    
    NSLog(@"User stream changed channel = %@, userId = %@, streamTrackModel = %@", channel.channel, userId, streamTrackModel);
}

RTCEngineChannel *channel = [[RTCEngineKit sharedEngine] createChannelWithDelegate:self];
/// The engine holds the channel instance; just keep your own reference to it
self.channel = channel;

RTCEngineError errorCode = [self.channel joinChannelWithToken:@"Your Token"];
if (errorCode != RTCEngineErrorOK) {
    NSLog(@"Failed to join the channel");
}

[self.channel leaveChannel:^{
    /// TO DO...
}];

[self.channel destroy];
self.channel = nil;

[[RTCEngineKit sharedEngine] startLocalPreview:YES view:self.localView];

[[RTCEngineKit sharedEngine] updateLocalView:self.localView];

[[RTCEngineKit sharedEngine] stopLocalPreview];

[self.channel publishLocalVideo:YES];

[self.channel startRemoteView:userId trackId:trackId view:self.previewView];

[self.channel updateRemoteView:userId trackId:trackId view:self.previewView];

[self.channel stopRemoteView:userId trackId:trackId];

[self.channel stopAllRemoteViewWithUserId:userId];

[[RTCEngineKit sharedEngine] destroy];