文档首页/ 华为云会议 Meeting/ 客户端SDK参考/ iOS SDK/ 接口参考/ 会议控制/ 发起立即会议
更新时间：2025-07-28 GMT+08:00
查看PDF
分享

发起立即会议

startP2PConf

接口描述

该接口用于发起立即会议。

注意事项

1. 实际业务处理结果在对应的callback回调中。

方法定义

- (void)startP2PConf:(HWMStartP2PConfParam *)param callback:(_Nonnull HWMSDKCreateConfCompleteHandler)callback;

参数描述

参数

是否必须

类型

描述

param

是

HWMStartP2PConfParam *

发起立即会议信息。
表1 HWMStartP2PConfParam 说明

参数

是否必须

类型

描述

calleeInfo

是

HWMCalleeInfo *

被叫信息。

callerInfo

是

HWMCallerInfo *

主叫信息。

mediaType

是

HWMMediaType

参数解释：

媒体类型。

约束限制：

不涉及。

默认取值：

HWMMediaTypeAudio 音频。

isGuestJoinConfWithoutPwd

是

BOOL

参数解释：

是否来宾免密码入会。

约束限制：

不涉及。

默认取值：

NO 来宾不免密。

confAllowJoinUser

是

HWMJoinConfRestrictionType

参数解释：

允许入会的用户类型。

约束限制：

不涉及。

默认取值：

HWMJoinConfRestrictionAll 所有用户。

isSpeakerOff

否

BOOL

参数解释：

是否关闭扬声器。

约束限制：

不涉及。

默认取值：

NO 不关闭。
表2 HWMCallerInfo 说明

参数

是否必须

类型

描述

nickName

否

NSString *

参数解释：

主叫名称。

约束限制：

不涉及。

取值范围：

0-256个字符。

默认取值：

不涉及。
表3 HWMCalleeInfo 说明

参数

是否必须

类型

描述

nickName

否

NSString *

参数解释：

被叫名称。

约束限制：

不涉及。

取值范围：

0-256个字符。

默认取值：

不涉及。

number

是

NSString *

参数解释：

被叫号码。

约束限制：

如果填分配给账号的sip号码（如+99111244216210249）则呼叫该账号的App；如果填PSTN号码（如18700000000），则通过VoIP网关呼叫该号码，前提是该企业已开通PSTN呼叫权限。与thirdUserId二选一，账号密码鉴权时使用。

取值范围：

0-128个字符。

默认取值：

不涉及。

thirdUserId

是

NSString *

参数解释：

第三方用户ID。

约束限制：

与number二选一，App ID鉴权时使用。

取值范围：

0-129个字符

默认取值：

不涉及

type

是

HWMConfAttendeeType

参数解释：

用户类型。

约束限制：

不涉及。

默认取值：

HWMConfAttendeeTypeNormal 会议软终端用户。

orgId

否

NSString *

参数解释：

企业id。

约束限制：

不涉及。

取值范围：

0-32个字符。

默认取值：

不涉及。
表4 枚举HWMConfAttendeeType说明

枚举值

描述

HWMConfAttendeeTypeNormal

会议软终端用户。

HWMConfAttendeeTypeMobile

用户手机号码。

返回值

无

示例代码

- (void)startP2PConf {
    // 设置被叫信息
    HWMCalleeInfo *calleeInfo = [[HWMCalleeInfo alloc] init];
    calleeInfo.nickName = @"被叫姓名";
    calleeInfo.number = @"123456";
    calleeInfo.thirdUserId = @"123456";
    
    // 设置主叫信息
    HWMCallerInfo *callerInfo = [[HWMCallerInfo alloc] init];
    callerInfo.nickName = @"主叫姓名";
    
    HWMStartP2PConfParam *param = [[HWMStartP2PConfParam alloc] init];
    // 设置媒体类型
    param.mediaType = HWMMediaTypeVideo;
    param.calleeInfo = calleeInfo;
    param.callerInfo = callerInfo;
    // 调用SDK接口
    [[HWMSdk getOpenApi] startP2PConf:param callback:^(NSError * _Nullable error, HWMCreateConfResult * _Nullable result) {
        if (error) {
            [UIUtil showMessageWithError:error];
        } else {
            [UIUtil showMessage:[NSString stringWithFormat:@"会议ID：%@, isP2PConf:%@", result.confId, result.isP2PConf?@"YES":@"NO"]];
        }
    }];
}
父主题： 会议控制