SIP/H.323 设备支持
功能介绍
SDK 支持通过 SIP 和 H.323 标准协议与硬件视频会议系统或 PSTN 电话系统对接,可支持以下几种场景:
- SDK 呼叫单个对接端:从 SDK 端向对接端发起呼叫,对接端用户应答后与 SDK 一起进入房间;
- SDK 邀请多个对接端:SDK 端先进入房间,然后向一个或多个对接端用户发起邀请,被邀请用户接受邀请后加入该房间;
- 对接端呼叫 SDK:SDK 端在线,对接端向 SDK 端发起呼叫,SDK 端应答后与对接端一起加入房间;
- 对接端直接加入房间:SDK 房间提前建好,对接端呼叫房间号后加入房间;
以上对接端可以是支持 SIP/H.323 的硬件终端、传统电话、MCU 会议
功能开通
-
联系商务开通 SIP/H.323 对接功能,或在网站咨询客服。
-
登录 SDK 后台 ,选择 SIP 配置/H.323 配置,打开配置开关;如需配置中继模式,则填入对应的终端地址、端口号、协议(且 SIP 设备支持选择协议)。
- SIP 配置:

- H.323 配置:

SDK呼叫单个对接端
注意:
注意:
- 当用户 A 呼叫 SIP/H.323 设备时,对端设备需要在线,如果呼叫的是 E.164 号码,需要对应设备已注册,否则被呼叫端无法收到被呼叫的消息;设备收到呼叫消息后,根据其自身设置的应答机制,会自动进入房间或在按下接听后进入房间。
- 如果在 功能开通 的"SIP 配置"或者"H.323 配置"界面配置了中继地址,呼叫时不需要填写对端设备 IP,直接填写"sip:号码"或者"h323:号码"即可
- 调用接口:
import { CrSDK } from '@cr/react-native-rtc';
//被呼叫的SIP/H.323设备的IP或E.164号码,以sip:或h323:为前缀
const calledUID = 'sip:192.168.0.10'; // 呼叫IP为192.168.0.10的SIP设备
// const calledUID = 'h323:149689338'; // 呼叫E.164号码为14989338的H.323设备
const meetID = { confId: 88888888 };
const result = await CrSDK.instance.call(calledUID, meetID);
呼叫相关 API 请参考:
SDK邀请多个对接端
注意:
注意:
- 仅当用户 A 已经进入房间议,才可以邀请 SIP/H.323 设备。
- 当用户 A 邀请 SIP/H.323 设备时,对应设备需要在线,如果呼叫的是 E.164 号码,需要对应设备已注册,否则被邀请端无法收到被邀请的消息;设备收到邀请消息后,根据其自身设置的应答机制,会自动进入房间或在按下接听后进入房间。
- 如果在 功能开通 的"SIP 配置"或者"H.323 配置"界面配置了中继地址,邀请时不需要填写对端设备 IP,直接填写"sip:号码"或者"h323:号码"即可
- 调用接口:
//被邀请的SIP/H.323设备的IP或E.164号码,以sip:或h323:为前缀
const inviteeUsrID = 'sip:192.168.0.10'; // 邀请IP为192.168.0.10的SIP设备
// const inviteeUsrID = 'h323:149689338'; // 邀请E.164号码为14989338的H.323设备
const usrExtDat = JSON.stringify({ meeting: { ID: 88888888 } });
const result = await CrSDK.instance.invite(inviteeUsrID, usrExtDat);
- 回调通知:
import { CrSDKNotifier, NOTIFIER_EVENT } from '@cr/react-native-rtc';
class InviteListener extends CrSDKNotifier {
notifyInviteIn(notify: { inviteID: string; inviterUserID: string; usrExtDat?: string }) {}
// 邀请被接受,等待被邀请方进入房间等处理
notifyInviteAccepted(notify: { inviteID: string; usrExtDat?: string }) {}
// 邀请被拒绝,弹出提示框等处理
notifyInviteRejected(notify: { inviteID: string; usrExtDat?: string }) {}
notifyInviteCanceled(notify: { inviteID: string; usrExtDat?: string }) {}
}
const listener = new InviteListener();
listener.addCrNotifierListener([
NOTIFIER_EVENT.notifyInviteIn,
NOTIFIER_EVENT.notifyInviteAccepted,
NOTIFIER_EVENT.notifyInviteRejected,
NOTIFIER_EVENT.notifyInviteCanceled,
]);
相关 API 请参考:
对接端呼叫SDK
被呼叫的 SDK 端收到被他人呼叫通知,具体请参考 SDK 被呼叫 部分
对接端直接加入房间
下面以 Linphone 为例演示直接加入房间的方法:
- 二次拨号方式,呼叫 sip:116.63.139.166 或者 h323:116.63.139.166 (实际云服务地址请咨询商务),呼通后根据界面提示输入房间号,再输入"#"键以进入对应房间
- 拨号界面

- 输入房间号界面

- 直接呼叫房间号方式,呼叫 10252565@116.63.139.166 ,进入对应房间

配置终端
下面以宝利通硬终端和 Linphone 软终端为例,说明终端的配置方法。
宝利通终端
-
登录 web 管理页面,左侧导航栏选择管理设置 → 网络 →IP 网络
-
启用 SIP 呼叫,注:如果在 SDK 后台配置 SIP 时选择了协议,此处应选择一致的传输协议

-
启用 H.323 呼叫:

Linphone 软终端
- 打开偏好设置,选择视频,在下方添加 H264 解码器并确保开启
