Help Center/ Meeting/ Client SDK Reference/ macOS SDK/ APIs/ Meeting Control/ Joining a Meeting

Updated on 2024-07-30 GMT+08:00

View PDF

Joining a Meeting

joinConf

API Description

This API is used to join an existing meeting by using the meeting ID and password. The following two methods can be used to join a meeting:

Enter the meeting ID and password.
Use a meeting ID to join a meeting in random mode. The meeting link (for example, https://bmeeting.huaweicloud.com/#/j/981924330/e11ddec62ee760734fcf2ba55b79937eac2aa68677caf659) in the notification email contains the meeting ID (981924330) and random code (e11ddec62ee760734fcf2ba55b79937eac2aa68677caf659).

Precautions

Use the child class HWMJoinConfParam to join a meeting using the ID, and use the child class HWMRandomConfParam to join a meeting in random mode.
This API can be called regardless of whether you have logged in.
The actual service processing result can be obtained by calling the corresponding callback API.

Method Definition

    
         - (void)joinConf:(HWMBaseJoinConfParam * _Nonnull)param callback:(_Nonnull HWMSDKCompleteHandler)callback;

Parameter Description

**Table 1** HWMBaseJoinConfParam
Parameter	Mandatory	Type	Description
confId	Yes	NSString *	Meeting ID.
nickname	No	NSString *	Display name in the meeting. If you have logged in, this parameter can be left blank. In such a case, the login username is used as the display name in the meeting.
isCameraOn	No	BOOL	Whether to turn on the camera. By default, the camera is turned off.
isMicOn	No	BOOL	Whether to turn on the microphone. By default, the microphone is turned on.
isSpkOn	No	BOOL	Whether to unmute the speaker. By default, the speaker is unmuted.

**Table 2** HWMJoinConfParam description (inherited from HWMBaseJoinConfParam)
Parameter	Mandatory	Type	Description
password	No	NSString *	Meeting password. To join a meeting as a host, pass the host password. To join a meeting as a guest, pass the guest password unless the meeting is password-free.
isStopConflictConf	No	BOOL	Used to forcibly end a meeting that conflicts with the current cloud meeting room. (Only the owner of the cloud meeting room resource has the permission.)

**Table 3** HWMRandomConfParam description (inherited from HWMBaseJoinConfParam)
Parameter	Mandatory	Type	Description
random	Yes	NSString *	This parameter is transferred when you join a meeting in random mode.
domain	No	NSString *	Domain name. This parameter is used when you join the meeting offline.

Sample Code

    
     
       
       
         /// Join a meeting.
- (void)joinMeeting {
    HWMJoinConfParam *param = [[HWMJoinConfParam alloc] init];
    param.confId = @"989156631";
    param.password = getPassword();
    param.nickname = @"Hangzhou site";
    param.isCameraOn = NO;
    param.isMicOn = YES;
    [[HWMSdk getOpenApi] joinConf:param callback:^(NSError * _Nullable error, id  _Nullable result) {
        if (error) {
            NSLog(@"Join meeting failed.%@", error.localizedDescription);
        }else{
            NSLog(@"Meeting joined.");
        }
    }];
}
// Join a meeting in random mode.
- (void)joinMeetingByRandom {
    HWMRandomConfParam *param = [[HWMRandomConfParam alloc] init];
    param.confId = @"989156631";
    param.random = getRandom();
    param.nickname = @"Hangzhou site";
    param.isCameraOn = NO;
    param.isMicOn = YES;
    [[HWMSdk getOpenApi] joinConf:param callback:^(NSError * _Nullable error, id  _Nullable result) {
        [self hideLoading];
        if (error) {
            NSLog(@"Join meeting failed.%@", error.localizedDescription);
        }else{
            NSLog(@"Meeting joined.");
        }
    }];
}

        

      

    
   