鸿蒙分布式投屏

鸿蒙AVSession Kit------ ArkTS 与 C/C++ 双语言、Provider 与 Controller 全角 - 掘金

适用：API 12+ / ArkTS & C++ / 手机→智慧屏、耳机、车机等任意分布式设备

一、投播全景图

二、核心概念 1 张表

概念作用备注 AVCastPicker 系统 UI，列出可投设备一行代码唤起 AVCastController 跨设备会话控制器与本地 AVSessionController 同族 CastState 枚举：IDLE / CONNECTING / CONNECTED / DISCONNECTING 监听投播链路状态 CastPlayback 投播过程中的播放状态仍通过本地 AVSession 同步

三、ArkTS 最小落地（4 步 8 行）

准备本地会话（与本地播放完全一致）

ts 复制代码

const session = await avSession.createAVSession(getContext(), 'MusicCast', 'audio');
await session.setAVMetadata({...});
await session.setAVPlaybackState({...});
await session.activate();

唤起投播面板

ts 复制代码

import { avCast } from '@kit.AVSessionKit';
const picker = new avCast.AVCastPicker();
picker.show(session.sessionId);          // ① 一行弹出设备列表

监听投播状态

ts 复制代码

session.on('castStateChange', (state: avCast.CastState) => {
  console.info('投播状态', state);       // ② 连接/断开/失败
});

远端控制

ts 复制代码

const castCtrl = await session.createCastController(); // ③ 拿到跨设备控制器
await castCtrl.sendControlCommand({ command: 'pause' });

四、C/C++ NDK 最小落地

cpp 复制代码

// 1. 创建本地会话
OH_AVSession* session;
OH_AVSession_Create("CastDemo", SESSION_TYPE_AUDIO,
                    "com.demo", "MainAbility", &session);

// 2. 唤起投播面板
OH_AVCastPicker_Show(session);

// 3. 监听状态
OH_AVSession_RegisterCastStateCallback(session,
  [](OH_AVSession*, CastState state, void*){ /* 处理 */ }, nullptr);

// 4. 远端控制
OH_AVCastController* castCtrl;
OH_AVCastController_Create(session, &castCtrl);
OH_AVControllerCommand cmd = { .command = COMMAND_PAUSE };
OH_AVCastController_SendCommand(castCtrl, &cmd);

五、投播生命周期事件

事件触发时机建议动作 castStateChange 连接/断开/失败切换 UI（本地 ↔ 远端） castPlaybackStateChange 远端播放状态变化同步进度条 castOutputDeviceChange 可用设备列表变化刷新投播面板

注册示例（ArkTS）

ts 复制代码

session.on('castPlaybackStateChange', (state) => updateProgress(state.position));
session.on('castOutputDeviceChange',   (list) => refreshPicker(list));

六、后台投播 checklist

本地会话已激活并设置元数据
申请了 AUDIO_PLAYBACK 长时任务（投播期间仍在后台播放）
监听 castStateChange，在 DISCONNECTED 时切回本地播放器
远端设备断开后主动 release() CastController 避免泄漏

七、一句话总结

"把本地 AVSession 搭好，加一行 AVCastPicker.show()，其余全部复用现有播放逻辑。"