@ohos.multimedia.avCastPicker (投播组件)

本模块提供创建投播组件AVCastPicker的功能，提供设备发现连接的统一入口。

说明：

  • 本模块首批接口从API version 10开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
  • 示例效果请以真机为准，当前IDE预览器无实际投播功能。
  • 当前组件的使用，依赖于设备支持“设备选择界面”。当前暂无OpenHarmony设备支持，需要OEM厂商实现具体的“设备选择界面”。

导入模块

import AVCastPicker from '@ohos.multimedia.avCastPicker';

接口

AVCastPicker()

投播组件，可用于将音视频资源投放到其它设备播放。

该组件为自定义组件，开发者在使用前需要先了解@Component。

系统能力： SystemCapability.Multimedia.AVSession.AVCast

属性

除支持通用属性外，还支持以下属性：

名称 参数类型 描述
normalColor Color | number | string 指正常状态下投播组件的颜色
activeColor Color | number | string 指设备切换成功状态下投播组件的颜色
onStateChange (state: AVCastPickerState) => void 投播状态更改回调

事件

支持通用事件。

示例

投播功能的示例说明参考如下。

import AVCastPicker from '@ohos.multimedia.avCastPicker'
import { AVCastPickerState } from '@ohos.multimedia.avCastPickerParam'

@Entry
@Component
struct Index {
  private onStateChange(state: AVCastPickerState) {
    if (state == AVCastPickerState.STATE_APPEARING) {
      console.log('The picker starts showing.')
    } else if (state == AVCastPickerState.STATE_DISAPPEARING) {
      console.log('The picker finishes presenting.')
    }
  }

  build() {
    Row() {
      Column() {
        AVCastPicker({ normalColor: Color.Red, activeColor: Color.Blue, onStateChange: this.onStateChange })
          .width('40vp')
          .height('40vp')
          .border({ width: 1, color: Color.Red })
      }.height('50%')
    }.width('50%')
  }
}