harmony 鸿蒙使用通话设备切换组件

  • 2025-06-12
  • 浏览 (4)

使用通话设备切换组件

切换通话输出设备

系统不再提供音频输出设备切换的API，如果需要应用内切换音频输出设备，请实现AVCastPicker组件，相关参数可参考@ohos.multimedia.avCastPicker 和 @ohos.multimedia.avCastPickerParam。

本文将主要介绍AVCastPicker组件接入，实现通话输出设备切换功能。

当前系统支持两种组件样式的显示方式：默认样式显示和自定义样式显示。 - 如果应用选择显示默认样式，当设备切换时，系统将根据当前选择的设备显示系统默认的组件样式。 - 如果应用选择显示自定义样式，那么需要应用根据设备的变化刷新自己定义的样式。

默认样式实现

  1. 创建voice_call类型的AVSession，AVSession在构造方法中支持不同的类型参数，由AVSessionType定义，voice_call表示通话类型，如果不创建，将显示空列表。
    import { avSession } from '@kit.AVSessionKit';
    @Entry
    @Component
    struct Index {
      @State message: string = 'hello world';
    
      build() { 
        Column() {
            Text(this.message)
              .onClick(()=>{
                let context = this.getUIContext().getHostContext() as Context;
                // 通话开始时创建voice_call类型的avsession。
                let session: AVSessionManager.AVSession = await AVSessionManager.createAVSession(context, 'voiptest', 'voice_call');
              })
          }
        .width('100%')
        .height('100%')
      }
    }
  1. 在需要切换设备的通话界面创建AVCastPicker组件。
   import { AVCastPicker } from '@kit.AVSessionKit';

   // 创建组件，并设置大小。
   build() {
     Row() {
       Column() {
         AVCastPicker()
           .size({ height:45, width:45 })
       }
     }
   }
  1. 创建VOICE_COMMUNICATION类型的AudioRenderer，并开始播放。具体通话音频播放等实现，请参考AudioKit开发音频通话功能。
   import { audio } from '@kit.AudioKit';
   import { BusinessError } from '@kit.BasicServicesKit';

   private audioRenderer: audio.AudioRenderer|undefined = undefined;
   private audioStreamInfo: audio.AudioStreamInfo = {
     // 请按照实际场景设置，当前参数仅参考。
     samplingRate: audio.AudioSamplingRate.SAMPLE_RATE_48000, // 采样率。
     channels: audio.AudioChannel.CHANNEL_2, // 通道。
     sampleFormat: audio.AudioSampleFormat.SAMPLE_FORMAT_S16LE, // 采样格式。
     encodingType: audio.AudioEncodingType.ENCODING_TYPE_RAW // 编码格式。
   }
   private audioRendererInfo: audio.AudioRendererInfo = {
     // 需使用通话场景相应的参数。
     usage: audio.StreamUsage.STREAM_USAGE_VIDEO_COMMUNICATION, // 音频流使用类型：VOIP视频通话，默认为扬声器。
     rendererFlags: 0 // 音频渲染器标志：默认为0即可。
   }
   private audioRendererOptions: audio.AudioRendererOptions = {
     streamInfo: this.audioStreamInfo,
     rendererInfo: this.audioRendererInfo
   }

   // 初始化，创建通话audiorenderer实例，设置监听事件。
   try {
    this.audioRenderer = await audio.createAudioRenderer(this.audioRendererOptions);
   } catch (err) {
    console.error(`audioRender create :  Error: ${JSON.stringify(err)}`);
   }

   this.audioRenderer?.start((err: BusinessError) => {
    if (err) {
      console.error(`audioRender start faild :  Error: ${JSON.stringify(err)}`);
    } else {
      console.error('audioRender start success');
    }
   });
  1. （可选）如果应用想知道设备切换情况，可以监听当前发声设备切换回调。
   import { audio } from '@kit.AudioKit';

   let audioManager = audio.getAudioManager(); // 先创建audiomanager。
   let audioRoutingManager = audioManager.getRoutingManager(); // 再调用AudioManager的方法创建AudioRoutingManager实例。

   // 可选监听当前发声设备切换回调。
   audioRoutingManager.on('preferOutputDeviceChangeForRendererInfo', this.audioRendererInfo, (desc: audio.AudioDeviceDescriptors) => {
     console.info(`device change To : ${desc[0].deviceType}`); // 设备类型。
   });
  1. 通话结束后，销毁会话。
   // 通话结束销毁第一步创建的session。
   this.session?.destroy((err) => {
     if (err) {
       console.error(`Failed to destroy session. Code: ${err.code}, message: ${err.message}`);
     } else {
       console.info(`Destroy : SUCCESS `);
     }
   });

自定义样式实现

自定义样式通过设置CustomBuilder类型的参数customPicker实现。

实现自定义样式的步骤与实现默认样式基本相同，开发者可参考默认样式实现，完成创建AVSession、实现音频播放等步骤。

存在差异的步骤如下所示。

  1. 创建自定义AVCastPicker，需要新增自定义参数。（对应默认样式实现步骤2）
   import { AVCastPicker } from '@kit.AVSessionKit';

   @State pickerImage:ResourceStr = $r('app.media.earpiece'); // 自定义资源。

   build() {
     Row() {
       Column() {
         AVCastPicker(
           {
             customPicker: (): void => this.ImageBuilder() // 新增自定义参数。
           }
         ).size({ height: 45, width:45 })
       }
     }
   }

   // 自定义内容。
   @Builder
   ImageBuilder(): void {
     Image(this.pickerImage)
       .size({ width: '100%', height: '100%' })
       .backgroundColor('#00000000')
       .fillColor(Color.Black)
   }
  1. 如果应用要根据出声设备变化而改变自定义样式，必须监听设备切换，然后实时刷新自定义样式。（对应默认样式实现步骤4）
   import { audio } from '@kit.AudioKit';

   async observerDevices() {
     let audioManager = audio.getAudioManager();
     let audioRoutingManager = audioManager.getRoutingManager();

     // 初次拉起AVCastPicker时需获取当前设备,刷新显示。
     this.changePickerShow(audioRoutingManager.getPreferredOutputDeviceForRendererInfoSync(this.audioRendererInfo));

     // 监听当前发声设备切换，及时根据不同设备类型显示不同的样式。
     audioRoutingManager.on('preferOutputDeviceChangeForRendererInfo', this.audioRendererInfo, (desc: audio.AudioDeviceDescriptors) => {
       this.changePickerShow(audioRoutingManager.getPreferredOutputDeviceForRendererInfoSync(this.audioRendererInfo));
     });
   }

   // 设备更新后刷新自定义资源pickerImage。
   private changePickerShow(desc: audio.AudioDeviceDescriptors) {
     if (desc[0].deviceType === 2) {
       this.pickerImage = $r('app.media.sound');
     } else if (desc[0].deviceType === 7) {
       this.pickerImage = $r('app.media.bluetooth');
     } else {
       this.pickerImage = $r('app.media.earpiece');
     }
   }

切换通话输入设备（仅在PC/2in设备可用）

系统不再提供音频输入设备切换的API，如果需要在应用内切换音频输入设备，并实现AVInputCastPicker组件，相关参数可参考@ohos.multimedia.avInputCastPicker 和 @ohos.multimedia.avCastPickerParam。

本文将主要介绍AVInputCastPicker组件接入，实现通话输入设备切换功能。

当前系统支持两种组件样式的显示方式：默认样式显示和自定义样式显示。 - 如果应用选择显示默认样式，当设备切换时，系统将根据当前选择的设备显示系统默认的组件样式。 - 如果应用选择显示自定义样式，那么需要应用根据设备的变化刷新自己定义的样式。

默认实现方式

  1. 在需要切换设备的通话界面创建AVInputCastPicker组件。
   import { AVCastPickerState, AVInputCastPicker } from '@kit.AVSessionKit';

   // 设备列表显示状态变化回调（可选）。
   private onStateChange(state: AVCastPickerState) {
     if (state == AVCastPickerState.STATE_APPEARING) {
       console.info('The picker starts showing.');
     } else if (state == AVCastPickerState.STATE_DISAPPEARING) {
       console.info('The picker finishes presenting.');
     }
   }

   // 创建组件，并设置大小。
   build() {
     Row() {
       Column() {
         AVInputCastPicker(
         {
           onStateChange: this.onStateChange
         }
         ).size({ height:45, width:45 })
       }
     }
   }
  1. 实现通话功能，请参考AudioKit开发音频通话功能。

自定义实现方式

自定义样式通过设置AVInputCastPicker中的参数customPicker实现。

  1. 创建自定义AVInputCastPicker，需要新增自定义参数。
   import { AVCastPickerState, AVInputCastPicker } from '@kit.AVSessionKit';

   @State pickerImage: ResourceStr = $r('app.media.earpiece'); // 自定义资源。

   // 设备列表显示状态变化回调（可选）。
   private onStateChange(state: AVCastPickerState) {
     if (state == AVCastPickerState.STATE_APPEARING) {
       console.info('The picker starts showing.');
     } else if (state == AVCastPickerState.STATE_DISAPPEARING) {
       console.info('The picker finishes presenting.');
     }
   }

   build() {
     Row() {
       Column() {
         AVInputCastPicker(
           {
             customPicker: (): void => this.ImageBuilder(), // 新增自定义参数。
             onStateChange: this.onStateChange
           }
         ).size({ height: 45, width:45 })
       }
     }
   }

   // 自定义内容。
   @Builder
   ImageBuilder(): void {
     Image(this.pickerImage)
       .size({ width: '100%', height: '100%' })
       .backgroundColor('#00000000')
       .fillColor(Color.Black)
   }
  1. 实现通话功能，请参考AudioKit开发音频通话功能。

你可能感兴趣的鸿蒙文章

harmony 鸿蒙AVSession Kit（音视频播控服务）

harmony 鸿蒙应用接入AVSession场景介绍

harmony 鸿蒙后台播放

harmony 鸿蒙AVSession Kit简介

harmony 鸿蒙分布式媒体会话概述(仅对系统应用开放)

harmony 鸿蒙本地媒体会话概述

harmony 鸿蒙媒体会话控制方(仅对系统应用开放)

harmony 鸿蒙媒体会话提供方

harmony 鸿蒙使用分布式媒体会话(仅对系统应用开放)

harmony 鸿蒙媒体会话提供方(C/C++)

0  赞
  • 所属分类： 后端技术
  • 本文标签：
  • 版权声明： 原创文章如转载，请注明本文链接: https://m.seaxiang.com/blog/xQTDuU
热门推荐
标签云
Linux Java Spring Spring Boot docker 大数据 前端 生活 maven golang 软件 spring cloud fintech mac vscode 其他 区块链 以太坊 V神 开发者 技术 股票 git greenplum 分布式事务 chrome mysql flink kafka 设计模式 原理 鸿蒙 seo
最新文章
本文目录