视图组件
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
}
})
}
}
相关结构体类型请参考: