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

发起立即会议

startP2PConf

接口描述

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

注意事项

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

方法定义

- (void)startP2PConf:(HWMUISDKStartCallInfoModel *)param callback:(_Nonnull HWMSDKCreateConfCompleteHandler)callback;
表1 HWMUISDKStartCallInfoModel说明

参数

是否必须

类型

描述

calleeInfo

是

HWMUISDKCalleeInfoModel*

被叫信息。

callerInfo

是

HWMUISDKCallerInfoModel*

主叫信息。

mediaType

是

HWMUISDKMediaType

参数解释：

媒体类型。

约束限制：

不涉及

默认取值：

HWMUISDKMediaTypeAudio 音频。

isGuestJoinConfWithoutPwd

否

BOOL

参数解释：

是否来宾免密码入会。

约束限制：

不涉及。

默认取值：

NO 来宾不免密。

confAllowJoinUser

否

HWMUISDKConfAllowJoinUserType

参数解释：

允许入会的用户类型。

约束限制：

不涉及。

默认取值：

HWMUISDKConfAllowJoinAnyone 所有用户。
表2 HWMUISDKCallerInfoModel 说明

参数

是否必须

类型

描述

nickName

否

NSString *

参数解释：

主叫名称。

约束限制：

不涉及。

取值范围：

0-256个字符。

默认取值：

不涉及。
表3 HWMUISDKCalleeInfoModel说明

参数

是否必须

类型

描述

nickName

否

NSString *

参数解释：

被叫名称。

约束限制：

不涉及。

取值范围：

0-256个字符。

默认取值：

不涉及。

number

是

NSString *

参数解释：

被叫号码。

约束限制：

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

取值范围：

0-128个字符。

默认取值：

不涉及。

thirdUserId

是

NSString *

参数解释：

第三方用户ID。

约束限制：

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

取值范围：

0-128个字符。

默认取值：

不涉及。

corpId

否

NSString *

参数解释：

企业id。

约束限制：

不涉及。

取值范围：

0-32个字符。

默认取值：

不涉及。
表4 枚举HWMUISDKMediaType说明

枚举值

描述

HWMUISDKMediaTypeAudio

音频类型。

HWMUISDKMediaTypeVideo

视频类型。
表5 枚举HWMUISDKConfAllowJoinUserType说明

枚举名称

枚举值

枚举说明

HWMUISDKConfAllowJoinAnyone

0

所有用户。

HWMUISDKConfAllowJoinLoginedUser

1

已登录用户。

HWMUISDKConfAllowJoinInCompanyUser

2

企业内用户。

HWMUISDKConfAllowJoinInvitedUser

3

被邀请用户。

返回值

无

示例代码 
- (void)startP2PConf {
    // 设置被叫信息
    HWMUISDKCalleeInfo *calleeInfo = [[HWMUISDKCalleeInfo alloc] init];
    calleeInfo.nickName = @"被叫姓名";
    calleeInfo.number = @"123456";
    calleeInfo.thirdUserId = @"123456";
    
    // 设置主叫信息
    HWMUISDKCallerInfo *callerInfo = [[HWMUISDKCallerInfo alloc] init];
    callerInfo.nickName = @"主叫姓名";
    
    HWMUISDKStartCallInfoModel *param = [[HWMUISDKStartCallInfoModel alloc] init];
    // 设置媒体类型
    param.mediaType = HWMUISDKMediaTypeVideo;
    param.calleeInfo = calleeInfo;
    param.callerInfo = callerInfo;
    // 调用SDK接口
    [[HWMSdk getOpenApi] startP2PConf:param callback:^(NSError * _Nullable error, HWMCreateConfResult * _Nullable result) {
        if (error) {
            NSLog(@"发起立即会议失败：%@", error.localizedDescription);
        } else {
            NSLog(@"发起立即会议成功");
        }
    }];
}
父主题： 会议控制