Updated on 2023-03-23 GMT+08:00

Joining a Meeting

joinConf

API Description

This API is used to join an existing meeting by using the meeting ID and password. You can join a meeting in either of the following ways:

  • 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

  1. 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.
  2. This API can be called regardless of whether you have logged in.
  3. The actual service processing result can be obtained by calling the corresponding callback API.

Method Definition

1
- (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

Yes

BOOL

Whether to turn on the camera. By default, the camera is turned off.

isMicOn

Yes

BOOL

Whether to turn on the microphone. By default, the microphone is turned on.

Table 2 HWMJoinConfParam parameters (inherited from HWMBaseJoinConfParam)

Parameter

Mandatory

Type

Description

password

No

NSString *

Meeting password. If you want to join a meeting as a host, you must enter the host password. If you want to join a meeting as a guest, enter the guest password or leave the password empty as required.

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 parameters (inherited from HWMBaseJoinConfParam)

Parameter

Mandatory

Type

Description

random

Yes

NSString *

This parameter is transferred when you join a meeting in random mode.

Sample Code

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
/// Join a meeting.
- (void)joinMeeting {
    HWMJoinConfParam *param = [[HWMJoinConfParam alloc] init];
    param.confId = @"989156631";
    param.password =@"807766";
    param.nickname = @"Hangzhou site";
    param.isCameraOn = NO;
    param.isMicOn = YES;
    [[HWMSdk getOpenApi] joinConf:param callback:^(NSError * _Nullable error, id  _Nullable result) {
        if (error) {
            NSLog(@"Failed to join the meeting %@", error.localizedDescription);
        }else{
            NSLog(@"Meeting joined.");
        }
    }];
}
// Join a meeting in random mode.
- (void)joinMeetingByRandom {
    HWMRandomConfParam *param = [[HWMRandomConfParam alloc] init];
    param.confId = @"989156631";
    param.random = @"1da9ec437c5aa24beb1e2b67c783f59d0859c578022ba88c";
    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(@"Failed to join the meeting %@", error.localizedDescription);
        }else{
            NSLog(@"Meeting joined.");
        }
    }];
}