🔊 前言：为什么不直接用蓝牙？

🏗️ 一、 架构原理：AVSession 是指挥官

要实现流转，你的 App 必须接入AVSession (音视频会话)。
系统通过 AVSession 知道你的 App 正在放什么歌、进度是多少。当用户点击“流转”或手机靠近音箱时，系统接管 AVSession，将其“投影”到远端设备。

流转原理图 (Mermaid):

🛠️ 二、 实战步骤：从发现到连接

在 HarmonyOS Next 中，流转主要依赖AVCastController或AudioRoutingManager。这里我们演示最通用的AVSession 投射模式。

1. 基础准备：创建 AVSession

这是所有播放类 App 的起手式。不写这个，系统根本不知道你在放歌。

import{avSession}from'@kit.AVSessionKit';letsession:avSession.AVSession;asyncfunctioninitSession(context:Context){// 1. 创建会话，类型为音频 (AUDIO)session=awaitavSession.createAVSession(context,'MyMusicApp','audio');// 2. 激活会话awaitsession.activate();// 3. 设置元数据 (歌名、歌手、封面)// 这一步很重要，流转到音箱后，如果音箱有屏幕，会显示这些信息letmetadata:avSession.AVMetadata={assetId:'123',title:'海阔天空',artist:'Beyond',mediaImage:'https://example.com/cover.jpg'};awaitsession.setAVMetadata(metadata);console.info('AVSession 初始化完成');}

2. 核心逻辑：发现并流转到音箱

我们要调用AVCastController来扫描局域网内的鸿蒙设备（音箱、智慧屏），并指定输出。

import{avSession}from'@kit.AVSessionKit';import{BusinessError}from'@kit.BasicServicesKit';asyncfunctioncastToSpeaker(){if(!session)return;// 1. 获取投射控制器letcastController=awaitsession.getAVCastController();// 2. 监听设备发现 (类似于蓝牙扫描，但是是在 Wi-Fi/软总线上扫)castController.on('castDeviceChange',(state:avSession.AVCastDeviceState,device:avSession.AVCastDeviceInfo)=>{console.info(`发现设备:${device.deviceId}, 状态:${state}`);// 3. 简单的自动流转逻辑：发现是“音箱”，就直接切过去// 实际业务中，应该弹窗让用户选择if(state===avSession.AVCastDeviceState.DEVICE_STATE_CONNECTED){// 设备已连接，准备就绪}});// 4. 发起流转指令// startCast 会触发系统的设备选择弹窗 (AirPlay 风格)// 如果你想自己写 UI，需要使用 getOutputDevices() 手动切换try{// 这里的 'audio' 表示我们只投射音频awaitcastController.startCast('audio');console.info('已拉起系统流转弹窗');}catch(err){leterror=errasBusinessError;console.error(`流转失败:${error.message}`);}}

3. 处理流转后的状态 (同步播放进度)

当流转成功后，音频实际上是从音箱发出的。你的 App 需要监听来自音箱的指令（比如用户对着音箱喊“下一首”）。

// 监听远端指令session.on('play',()=>{// 音箱发来“播放”指令player.play();});session.on('pause',()=>{// 音箱发来“暂停”指令player.pause();});session.on('playNext',()=>{// 音箱发来“下一首”指令playNextSong();});

📡 三、 进阶：如何实现“碰一碰”自动流转？

上面的代码是“手动点击”触发流转。如果要实现华为音乐那种“手机碰一下音箱就流转”，需要结合NFC和Want机制。

逻辑极其简单：

1. NFC 标签写入：在音箱的 NFC 贴纸里写入你的 App 的Ability信息。
2. 手机读取：手机碰到 NFC，系统读取到 Ability 信息，自动拉起你的 App。
3. 触发流转：
   在 App 的onCreate或onNewWant生命周期中，判断启动来源。如果是NFC触发，直接执行上面的castToSpeaker()逻辑，并指定 deviceId（NFC数据里通常包含音箱的 MAC/ID）。

// EntryAbility.tsonNewWant(want:Want,launchParam:AbilityConstant.LaunchParam){// 判断是否由 NFC 碰一碰触发if(want.parameters&&want.parameters['ohos.extra.param.deviceType']==='speaker'){// 获取音箱 IDletspeakerId=want.parameters['deviceId'];// 执行静默流转AudioManager.transferTo(speakerId);}}

🚧 四、 避坑指南

1. 权限问题：跨设备发现和连接需要ohos.permission.DISTRIBUTED_DATASYNC权限，且这是个 ACL 权限（需要签名证书授权）。
2. 网络环境：流转的前提是设备必须在同一 Wi-Fi下，或者登录了同一个华为账号（利用超级终端能力）。
3. 流转模式：

• 本地解码 (Remote Audio)：手机下载解码，传 PCM 给音箱。适合实时性要求高的（游戏）。
• 远端解码 (Cast)：手机传 URL 给音箱，音箱自己下载。适合听歌，音质最好，手机最省电。
• AVSession 默认倾向于智能选择模式。

🎯 总结

鸿蒙的音频流转，把**“连接”变成了“服务”**。
通过AVSession，你开发的不是一个孤立的播放器，而是一个可以在全屋设备间自由穿梭的“音乐精灵”。

Next Step:
如果你手里没有华为音箱，可以找两台鸿蒙手机。一台装你的 App，另一台作为“接收端”（在设置里打开“超级终端 -> 允许被发现”）。尝试用你的 App 搜索另一台手机，你会发现它也会出现在设备列表里，点击它，音乐就会神奇地从另一台手机里飘出来！