Starting an Instant Meeting

Function

This API is used to start an instant meeting.

Function Prototype

startP2pConf(startCallInfo: StartCallInfo, onStartP2pConfResult?: (ret: SDKERR, reason: string, createConfResult: CreateConfResult) => void): voidstartP2pConf(startCallInfo: StartCallInfo, onStartP2pConfResult?: (ret: SDKERR, reason: string, createConfResult: CreateConfResult) => void): void

Request Parameters

**Table 1** Input parameter description
Parameter	Mandatory	Type	Description
startCallInfo	Yes	StartCallInfo	Information about starting an instant meeting.
onStartP2pConfResult	Yes	(ret: SDKERR, reason: string, createConfResult: CreateConfResult) => void	Callback of starting the instant meeting.

**Table 2** StartCallInfo
Parameter	Mandatory	Type	Description
callerInfo	Yes	CallerInfo	Caller information.
calleeInfo	Yes	CalleeInfo	Called participant information.
mediaType	Yes	MediaType	Media type.

**Table 3** CallerInfo
Parameter	Mandatory	Type	Description
nickName	No	string	Caller name.

**Table 4** CalleeInfo
Parameter	Mandatory	Type	Description
nickName	No	string	Called participant name.
number	Yes	string	Called number. If this parameter is set to the SIP number (for example, +99111244216210249) allocated to the account, the Huawei Cloud Meeting app is called. If this parameter is set to a PSTN number (for example, 18700000000), the number is called through the VoIP gateway if the enterprise has enabled PSTN call. This parameter is used for account and password authentication. Either this parameter or thirdUserId must be set (number is prior to thirdUserId).
thirdUserId	Yes	string	Third-party account of the called participant. Either this parameter or number is used. The priority is as follows: number > thirdUserId. This parameter is used for app ID authentication.
userUuid	No	string	Participant UUID.

**Table 5** Enumerated values of MediaType
Enumeration Name	Enumerated Value	Description
HWM_MEDIA_TYPE_AUDIO	0	Audio.
HWM_MEDIA_TYPE_VIDEO	1	Video.

Return Values

void

Callback Method Parameters

(ret: SDKERR, reason: string, createConfResult: CreateConfResult) => void

**Table 6** Input parameter description
Parameter	Type	Description
ret	For details about SDKERR, see Error Code Reference.	Error code.
reason	string	Error description.
createConfResult	CreateConfResult	Meeting creation result.

**Table 7** CreateConfResult
Parameter	Type	Description
confId	string	Meeting ID.
vmrConfId	string	Cloud meeting room ID (valid only for the macOS platform).
hostPwd	string	Host password.
guestPwd	string	Guest password.
mediaType	MediaType	Meeting media type (valid only for the macOS platform).
guestJoinUri	string	Guest link.
selfConfRole	ConfRole	Role in the meeting.
subject	string	Meeting topic.
startTime	number	Meeting start time, accurate to seconds (GMT).
endTime	number	Meeting end time.
schedulerName	string	Name of the user who schedules the meeting.
customInfo	string	Custom extension information.

**Table 8** Enumerated values of ConfRole
Enumeration Name	Enumerated Value	Description
HWM_CONF_ROLE_ATTENDEE	0	Common participant.
HWM_CONF_ROLE_HOST	1	Host.
HWM_CONF_ROLE_AUDIENCE	2	Attendee.
HWM_CONF_ROLE_COHOST	3	Co-host.
HWM_CONF_ROLE_WAITING	4	Waiting room member.