音视频通话

视图组件

CRCanvasView组件

在HarmonyOS RTC SDK中,底层会在CRCanvasView组件上绘制图形,它可以用于观看摄像头、屏幕共享、影音共享画面,其中包括观看自己或他人的视图画面。用户只需将CRCanvasView组件渲染到界面上并传入对应参数即可。
本文将介绍SDK层如何使用CRCanvasView组件绘制视图。

封装视图容器

示例代码:

import { CRCanvas, CRCanvasView } from '@cloudroom/harmony_rtcsdk';

@Component
export struct VideoComponent {
  @Prop canvas: CRCanvas;

  build() {
    CRCanvasView({
      canvasId: this.canvas.canvasId,
      canvasType: this.canvas.type,
      onLoad: () => {
        sdk_engine.addCanvas(this.canvas);
      },
      onDestroy: () => {
        sdk_engine.rmCanvas(this.canvas.canvasId)
      }
    })
  }
}

sdk_engine是SDK的实例,由create接口创建,addCanvas和rmCanvas API无需在onLoad或onDestroy时机调用,封装在组件内部可实现按需订阅和及时退订。

CRCanvasView:

参数 类型 说明
canvasId string 视图id,可传入uuid
canvasType CRVSDK_STREAM_VIEWTYPE 视图类型
onLoad function 视图创建时生命周期钩子
onDestroy function 视图销毁时生命周期钩子

相关API请参考:

相关结构体类型请参考:

使用视图容器

如果我们需要在一处观看userID是test的摄像头视图,可以按照下列代码:

import { CRVSDK_STREAM_VIEWTYPE } from '@cloudroom/harmony_rtcsdk';
import { util } from '@kit.ArkTS';

@Component
struct Index {
  userId: string = 'test';

  build() {
    VideoComponent({
      canvas: {
        canvasId: util.generateRandomUUID(), //视图id,这里使用鸿蒙的api创建uuid
        type: CRVSDK_STREAM_VIEWTYPE.CRVSDK_VIEWTP_VIDEO, //视图类型
        videoId: { userID: this.userId, videoID: -1 }, //用户视频id
      }
    })
  }
}

相关结构体类型请参考: