媒體數(shù)據(jù)寫入

子組件

構(gòu)造參數(shù)type為"surface"時(shí)不支持。

從API version 9開始，構(gòu)造參數(shù)type為"component"時(shí)可以包含子組件。

接口

XComponent(value: {id: string, type: string, libraryname?: string, controller?: XComponentController})

參數(shù):

屬性

• XComponent顯示的內(nèi)容，可由開發(fā)者自定義繪制，通用屬性不支持背景設(shè)置、透明度設(shè)置和圖像效果。
• type為"surface"時(shí)建議使用EGL/OpenGLES提供的接口設(shè)置相關(guān)內(nèi)容。
• type為"component"時(shí)建議使用掛載子組件的方式進(jìn)行設(shè)置相關(guān)內(nèi)容。

事件

僅type為"surface"時(shí)以下事件有效。不支持通用事件和手勢(shì)。

onLoad

onLoad(callback: (event?: object) => void )

插件加載完成時(shí)回調(diào)事件。

參數(shù):

onDestroy

onDestroy(event: () => void )

插件卸載完成時(shí)回調(diào)事件。

XComponentController

xcomponent 組件的控制器，可以將此對(duì)象綁定至XComponent組件，然后通過(guò)控制器來(lái)調(diào)用組件方法。

創(chuàng)建對(duì)象

xcomponentController: XComponentController = new XComponentController()

getXComponentSurfaceId

getXComponentSurfaceId(): string

獲取XComponent對(duì)應(yīng)Surface的ID，供@ohos接口使用，僅XComponent類型為"surface"時(shí)有效。

返回值:

setXComponentSurfaceSize

setXComponentSurfaceSize(value: {surfaceWidth: number, surfaceHeight: number}): void

設(shè)置XComponent持有Surface的寬度和高度，僅XComponent類型為"surface"時(shí)有效。

參數(shù):

getXComponentContext

getXComponentContext(): Object

獲取XComponent實(shí)例對(duì)象的context，僅XComponent類型為"surface"時(shí)有效。

返回值:

示例

示例效果請(qǐng)以真機(jī)運(yùn)行為準(zhǔn)，當(dāng)前IDE預(yù)覽器不支持。

// xxx.ets
@Entry
@Component
struct PreviewArea {
  private surfaceId : string =''
  xcomponentController: XComponentController = new XComponentController()
  build() {
    Row() {
      XComponent({
        id: 'xcomponent',
        type: 'surface',
        controller: this.xcomponentController
      })
        .onLoad(() => {
          this.xcomponentController.setXComponentSurfaceSize({surfaceWidth:1920,surfaceHeight:1080});
          this.surfaceId = this.xcomponentController.getXComponentSurfaceId()
        })
        .width('640px')
        .height('480px')
    }
    .backgroundColor(Color.Black)
    .position({x: 0, y: 48})
  }
}