Windows&Linux&Harmony

Windows

前提条件

• Visual Studio 2015 或以上版本。

• WIndows 7 或以上版本。

实现步骤

1、初始化RTC引擎及回调注册

class AliEngineEventListenerImpl : public AliEngineEventListener {
public:
    AliEngineEventListenerImpl(AliEngine* engine, HWND hWnd) {
        mAliRtcEngine = engine;
        mHWnd = hWnd;
    };
    virtual AliEngineEventListenerImpl() {};

    virtual void OnConnectionStatusChange(int status, int reason) override {
        if (status == AliEngineConnectionFailed) {
            /* TODO: 务必处理；建议业务提示客户，此时SDK内部已经尝试了各种恢复策略已经无法继续使用时才会上报 */
        } else {
            /* TODO: 可选处理；增加业务代码，一般用于数据统计、UI变化 */
        }
    };

    virtual void OnLocalDeviceException(AliEngineLocalDeviceType deviceType, AliEngineLocalDeviceExceptionType exceptionType, const char* msg) override {
        /* TODO: 务必处理；建议业务提示客户错误，此时SDK内部已经尝试了各种恢复策略已经无法继续使用时才会上报 */
    };

    virtual void OnJoinChannelResult(int result, const char *channel, const char *userId, int elapsed) override {
        /* TODO: 可选处理；增加业务代码，一般用于数据统计、UI变化 */
    };

    virtual void OnLeaveChannelResult(int result, AliEngineStats stats) override {
        
    };

    virtual void OnAuthInfoWillExpire() override {
        /* TODO: 务必处理；业务触发重新获取当前channel，user的鉴权信息，然后设置refreshAuthInfo即可 */
    };

    virtual void OnBye(int code) override {
        /* TODO: 建议业务根据自己的场景，进行对应的处理 */
    };

    virtual void OnRemoteUserOnLineNotify(const char *uid, int elapsed) override {
        
    };

    virtual void OnRemoteUserOffLineNotify(const char *uid, AliEngineUserOfflineReason reason) override {
        
    };

    virtual void OnRemoteTrackAvailableNotify(const char *uid,
                                                  AliEngineAudioTrack audioTrack,
                                                  AliEngineVideoTrack videoTrack) {
        AliEngineVideoCanvas remote_canvas;
        if (videoTrack == AliEngineVideoTrackCamera
                            || videoTrack == AliEngineVideoTrackBoth) {
            RECT rect;
            ::GetWindowRect(mHWnd, &rect);
            remote_canvas.displayView = remoteView;
            remote_canvas.renderMode = AliEngineRenderModeAuto;
            mAliRtcEngine->SetRemoteViewConfig(remote_canvas,uid,AliEngineVideoTrackCamera);
        } else {
            mAliRtcEngine->SetRemoteViewConfig(remote_canvas, uid, AliEngineVideoTrackCamera);
        }
    }

private:
    AliEngine* mAliRtcEngine = nullptr;
    /* windows 窗口句柄 */
    HWND mHWnd;
};


private:
void createEngine() {
    mAliRtcEngine = AliRtcEngine.Create("");
    mLisenter = new AliEngineEventListenerImpl(mAliRtcEngine, mHWnd);
    mAliRtcEngine->SetEngineEventListener(mLisenter);
}

2、设置入会前的参数

private:
void initEngineBeforeJoin() {
    /* 可选：入会前的参数设置 */
    mAliRtcEngine->SetChannelProfile(AliEngineInteractiveLive);
    mAliRtcEngine->SetClientRole(AliEngineClientRoleInteractive);
    /* 设置音频的属性 */
    mAliRtcEngine->SetAudioProfile(AliEngineBasicQualityMode, AliEngineSceneMusicMode);

    /* 可选：摄像头预览,不设置也会进行推流 */
    AliEngineVideoCanvas canvas;
    /* windows 窗口句柄 */
    canvas.view = mHWnd;
    mAliRtcEngine.setLocalViewConfig(canvas, AliEngineVideoTrackCamera);
}

3、入会

initEngineBeforeJoin();
mAliRtcEngine->joinChannel("您的鉴权信息", null, null, "testUserName");

4、切换角色

/* TODO: 根据业务设置角色 */
/* 设置参与互动角色（主播角色） */
mAliRtcEngine->SetClientRole(AliEngineClientRoleInteractive);
/* 设置观看角色（观众角色） */
mAliRtcEngine->SetClientRole(AliEngineClientRoleLive);

5、离会

mAliRtcEngine->LeaveChannel();

6、销毁引擎

mAliRtcEngine->Destroy();
mAliRtcEngine = nullptr;

效果展示

参考信息

Windows SDK

Linux

前提条件

Java准备工作

Python准备工作

C++准备工作

Golang准备工作

实现步骤

1、初始化RTC引擎及回调注册

Java初始化SDK

Python初始化SDK

C++初始化SDK

Golang初始化SDK

2、设置入会前的参数

Java设置入会参数

Python设置入会参数

C++设置入会参数

Golang设置入会参数

3、入会

Java入会

Python入会

C++入会

Golang入会

4、切换角色

Java切换角色

Python切换角色

C++切换角色

Golang切换角色

5、离会

Java离会

Python离会

C++离会

Golang离会

6、销毁引擎

Java销毁引擎

Python销毁引擎

C++销毁引擎

Golang销毁引擎

参考信息

Linux SDK

Harmony

前提条件

• 已联系华为商务人员，签署合作计划，开通相关权限，获取 DevEco Studio 5.0.3.900 Release 或以上版本。

• 获取配套 API Version 12的 HarmonyOS NEXT 5.0.0.102 操作系统或以上版本，支持音视频的鸿蒙设备，且已开启“允许调试”选项。

• 如果需要使用真机调试，请参考 鸿蒙官网文档 进行配置。

• 鸿蒙设备已经连接到 Internet。

• 已 注册华为开发者账号 并完成实名认证。

"dependencies": {
    "@aliyun_video_cloud/alivcsdk_artc":"6.11.0-beta",
}

ohpm install @aliyun_video_cloud/alivcsdk_artc

"dependencies": {
    "@aliyun_video_cloud/alivcsdk_artc":"file:./libs/AliVCSDK_ARTC-6.11.0-beta.har",
  }

实现步骤

1、初始化RTC引擎及回调注册

this.rtcSdk = AliRtcEngine.getInstance(NULL, getContext(this));
this.engineEventListener: AliRtcEngineEventListener = new AliRtcEngineEventListener();
this.engineEventListener
      .onRemoteUserOnline((uid: string, elapsed: boolean)=> {
        //有人入会
      })
      .onRemoteUserOffline((uid:string, reason: AliRtcUserOfflineReason)=> {
        //有人离会
      })
      .onJoinChannel((result : number, channel : string, userId : string, elapsed : number)=> {
        // 入会时触发
      })
      .onLeaveChannel((result : number, stat : AliRtcStats)=> {
        //离会时触发
      })
      
      .onBye((code : AliRtcOnByeType)=> {
        // 被服务器踢出或者频道关闭时回调
      })
      .onOccurError((error : number, msg : string)=> {
        // 发生错误时回调
      })
      
      .onConnectionStatusChange((status : number, reason : number)=> {
        //网络连接变化时回调
      })
    ;

  this.rtcSdk?.setRtcEngineEventListener(this.engineEventListener);

2、设置入会前的参数

initEngineBeforeJoin = (surfaceId: string) => {
 
  let encoderConfig : AliRtcVideoEncoderConfiguration = new AliRtcVideoEncoderConfiguration();
  encoderConfig.dimensions = new AliRtcVideoDimensions();
  encoderConfig.dimensions.width = 480
  encoderConfig.dimensions.height = 640
  encoderConfig.frameRate = AliRtcFrameRate.AliEngineFrameRateFps15
  this.rtcSdk?.setVideoEncoderConfiguration(encoderConfig)

  let profile : AliRtcChannelProfile = AliRtcChannelProfile.AliEngineInteractiveLive
  if (this.mainPageParams.interactive_mode == 0) {
    profile = AliRtcChannelProfile.AliEngineCommunication
  } else if (this.mainPageParams.interactive_mode == 2) {
    profile = AliRtcChannelProfile.AliEngineInteractiveWithLowLatencyLive
  }
  this.rtcSdk?.setChannelProfile(profile);
  this.rtcSdk?.setClientRole(this.mainPageParams.is_anchor ? AliRtcClientRole.AliEngineClientRoleInteractive : AliRtcClientRole.AliEngineClientRoleLive);


  this.localVideoCanvas.surfaceId = surfaceId;
  this.rtcSdk?.setLocalViewConfig(this.localVideoCanvas, this.componentController, AliRtcVideoTrack.AliEngineVideoTrackCamera);

}

3、入会

this.initEngineBeforeJoin();
this.rtcSdk?.joinChannel("您的鉴权信息", null, null, "testUserName");

4、切换角色

/* TODO: 根据业务设置角色 */
/* 设置参与互动角色（主播角色） */
this.rtcSdk?.setClientRole(AliRtcClientRole.AliEngineClientRoleInteractive);
/* 设置观看角色（观众角色） */
this.rtcSdk?.setClientRole(AliRtcClientRole.AliEngineClientRoleLive);

5、离会

this.rtcSdk?.leaveChannel();

6、销毁引擎

AliRtcEngine.destroyInstance();
this.rtcSdk? = null;

参考信息

Harmony SDK