Updated on 2024-07-30 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 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

 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 = getConfId();
    param.password = getPassword();
    param.nickname = getNickName();
    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 = getConfId();
    param.random = getRandom();
    param.nickname = getNickName();
    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.");
        }
    }];
}