产品百科 |RTC Windows SDK 手动推流和手动订阅的实现步骤

音视频通信 RTC(Real-Time Communication)是阿里云覆盖全球的实时音视频开发平台,依托核心音视频编解码、信道传输、网络调度技术,提供高可用、高品质、超低延时的音视频通信服务,让用户快速搭建多端实时应用,适用于在线教育、视频会议、互动娱乐、音视频社交等场景。


产品链接:https://www.aliyun.com/product/rtc


通过阅读本文,您可以了解手动推流和手动订阅的实现步骤。

背景信息

RTC SDK 提供了 setAutoPublish 接口,支持设置自动推流或自动订阅,设置自动推流时 SDK 会在加入频道后自动推流,设置自动订阅时 SDK 会在频道中有其他用户推流时自动进行订阅拉流,无需 App 进行操作。

如果您需要根据具体业务场景,按需进行推流或者拉流,可以使用手动推流或手动订阅方式。

推流端

  1. 创建引擎实例后,在加入频道前,设置关闭自动推流(设置参数 autoPub 为 false)。
// 创建引擎实例
AliRtcEngine *pEngine = AliRtcEngine::sharedInstance(this, "");
// 关闭自动推流/自动订阅
pEngine->setAutoPublishSubscribe(false, false);
  1. 配置后加入频道,并根据业务需要启动推流(音频 / 摄像头 / 屏幕采集),并通过回调确认推流是否成功,如果推流失败需要进行重试或提示用户。
    说明 必须在加入频道成功后才能开始推流,否则推流会失败,您需要关注加入频道结果是否成功。
// 配置推送音频流
pEngine->configLocalAudioPublish(true);
// 配置推送摄像头流
pEngine->configLocalCameraPublish(true);
// 配置推送屏幕分享流
pEngine->configLocalScreenPublish(true);
// 启动推流
auto callback = [](void *opaque, int errorCode) {
    if (errorCode == 0) {
        // 推流成功
    } else {
        // 推流失败
    }
};
pEngine->publish(callback, this);
  1. 当业务场景需要停止推流时,配置关闭上一步打开的媒体流并执行停止推流。
// 配置停止推送音频流
pEngine->configLocalAudioPublish(false);
// 配置停止推送摄像头流
pEngine->configLocalCameraPublish(false);
// 配置停止推送屏幕分享流
pEngine->configLocalScreenPublish(false);
// 停止推流
auto callback = [](void *opaque, int errorCode) {
};
pEngine->publish(callback, this);

订阅端

  1. 创建引擎实例后,在加入频道前,设置关闭自动订阅(设置参数 autoSub 为 false)。
// 创建引擎实例
AliRtcEngine *pEngine = AliRtcEngine::sharedInstance(this, "");
// 关闭自动推流/自动订阅
pEngine->setAutoPublishSubscribe(false, false);
  1. 配置后并成功加入频道,当频道中用户推流发送变化时,SDK 会回调 onRemoteTrackAvailableNotify 进行通知,回调中指明了推流用户及推送的媒体流。
    • audioTrack 为 AliRtcAudioTrackMic 时,代表该远端用户推送了音频流。
    • videoTrack 为 AliRtcVideoTrackCamera 或 AliRtcVideoTrackBoth 时,代表该远端用户推送了摄像头视频流。
    • videoTrack 为 AliRtcVideoTrackScreen 或 AliRtcVideoTrackBoth 时,代表该远端用户推送了屏幕分享视频流。
    • audioTrack 为 AliRtcAudioTrackNo 并且 videoTrack 为 AliRtcVideoTrackNo 时,代表该远端用户已停止推流。
// 接收到其他用户推流变化通知
void onRemoteTrackAvailableNotify(const AliRtc::String &uid,
    AliRtcAudioTrack audioTrack,
    AliRtcVideoTrack videoTrack)
{
    ...
}
  1. 说明
    • 在加入频道成功后,才会接收到频道中其他用户推流回调 onRemoteTrackAvailableNotify,您需要关注加入频道结果是否成功。
    • 回调 onRemoteTrackAvailableNotify 中指明了推流用户 ID,以及该用户发生状态变更的媒体流,您需要记录该用户已推送媒体流。
  1. 接收到推流回调后,可根据远端用户实际推送的媒体流及业务需要,配置订阅推流用户的媒体流,然后启动订阅。
// 配置订阅指定用户音频流
pEngine->configRemoteAudio(userId, true);
// 配置订阅指定用户摄像头流
pEngine->configRemoteCameraTrack(userId, false, true);
// 配置订阅指定用户屏幕分享流
pEngine->configRemoteScreenTrack(userId, true);
// 启动订阅
auto callback = [](void *opaque, const AliRtc::String &uid, AliRtcVideoTrack vt, AliRtcAudioTrack at) {
};
pEngine->subscribe(userId, callback, this);
  1. 说明
    • 在接收到远端用户的推流回调之后,您才能对该用户进行订阅拉流,否则订阅失败。
    • 您需要关注回调中远端用户实际推送的媒体流,对于没有推送的媒体流,订阅无法成功。
    • 如果远端用户状态已变为停止推流后,您不能对该用户执行订阅操作,直到再次接收到该用户重新开始推送媒体流的回调。
  1. 订阅成功后,订阅用户会接收到回调 onSubscribeChangedNotify,此时可设置用于显示视频流的 View(视图)。
    • audioTrack 为 AliRtcAudioTrackMic 时,代表已订阅远端用户推送了音频流。
    • videoTrack 为 AliRtcVideoTrackCamera 或 AliRtcVideoTrackBoth 时,代表已订阅远端用户摄像头视频流。
    • videoTrack 为 AliRtcVideoTrackScreen 或 AliRtcVideoTrackBoth 时,代表已订阅远端用户推送了屏幕分享视频流。
void onSubscribeChangedNotify(const AliRtc::String &uid,
    AliRtcAudioTrack audioTrack,
    AliRtcVideoTrack videoTrack) {
    if (at == AliRtcAudioTrackMic) {
        // 订阅音频流成功
    }
    if (vt == AliRtcVideoTrackCamera || vt == AliRtcVideoTrackBoth) {
        // 订阅摄像头流成功
        AliVideoCanvas cameraCanvas;
        ...
        pEngine->setRemoteViewConfig(&cameraCanvas, uid, AliRtcVideoTrackCamera);
    }
    if (vt == AliRtcVideoTrackScreen || vt == AliRtcVideoTrackBoth) {
        // 订阅屏幕流成功
        AliVideoCanvas screenCanvas;
        ...
        pEngine->setRemoteViewConfig(&screenCanvas, uid, AliRtcVideoTrackScreen);
    }
}
  1. 说明 onSubscribeChangedNotify 回调中返回了实际订阅远端用户媒体流的结果,您需要关注订阅结果是否与订阅配置一致,确认订阅是否成功。
  2. 当业务场景不需要订阅指定用户媒体流,或远端用户已停止推流时(参见步骤 2 中远端停止推流状态),配置并取消订阅对应用户。
// 配置取消订阅指定用户音频流
pEngine->configRemoteAudio(userId, false);
// 配置取消订阅指定用户摄像头流
pEngine->configRemoteCameraTrack(userId, false, false);
// 配置取消订阅指定用户屏幕分享流
pEngine->configRemoteScreenTrack(userId, false);
// 取消订阅
auto callback = [](void *opaque, const AliRtc::String &uid, AliRtcVideoTrack vt, AliRtcAudioTrack at) {
};
pEngine->subscribe(userId, callback, this);


「视频云技术」你最值得关注的音视频技术公众号,每周推送来自阿里云一线的实践技术文章,在这里与音视频领域一流工程师交流切磋。

产品百科 |RTC Windows SDK 手动推流和手动订阅的实现步骤

上一篇:产品百科 |RTC SDK AudioSession 多模块共享问题


下一篇:我在春晚现场护航直播