HarmonyOS 鸿蒙Next中播控中心未显示当前播放的音频

播控中心不展示，99% 不是 AVPlayer 的问题，而是 AVSession 没有处在“系统认为可展示的激活播放态”。你虽然 setAVMetadata 成功了，但只要下面任意一条没满足，播控中心就可能不出卡片/不显示音频信息。

必查点（按优先级）

1）session.activate() 调用时机不对 / 没激活成功

官方接入流程里强调：元数据、控制命令注册完成之后再 activate，否则可能被系统判定为无效会话或展示不完整。 正确顺序应是：

1. create session
2. setAVMetadata
3. 注册控制命令回调（play/pause/next/prev/seek 等，至少要有 play/pause）
4. await session.activate()
5. 播放开始后持续上报播放状态（state/position/speed 等）

（流程见“应用接入AVSession场景介绍”） Sources: https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/avsession-access-scene

2）你只设置了元数据，但 没有上报播放状态 / 或 state 不为 PLAY

播控中心是否展示，很依赖 setAVPlaybackState 里的状态。例如你元数据设置了，但一直上报的是 Pause/Stop，或根本没上报 position，系统可能不展示。

最低要求建议你在开始播放后做一次：

• state = PLAYBACK_STATE_PLAY
• position = 当前播放进度（ms）
• speed = 1.0

并且播放过程中建议定时更新 position（比如 500ms~1000ms 一次）。

3）AVSession 实例被释放（最常见“日志成功但界面没东西”）

如果你在某个函数里 let session = await createAVSession(...)，后面没有被成员变量/单例持有，页面切换或 GC 后 session 可能被释放，播控中心就不会显示。

做法：把 session 放到 Ability 级单例或页面的成员字段里，确保播放期间一直存在。

4）没有注册控制命令（至少 play/pause）

播控中心的卡片本质是“可控的媒体会话”。如果你只上报 metadata，但 没有注册播控回调，有些版本会不展示或展示异常。

建议至少注册：

• on('play')
• on('pause')（如果你想要进度条可拖动再加 on('seek')）

一个最小正确骨架（你对照改）

import { avSession as AVSessionManager } from '@kit.AVSessionKit';

class PlayerSessionHolder {
  session?: AVSessionManager.AVSession

  async init(ctx: Context, durationMs: number) {
    this.session = await AVSessionManager.createAVSession(ctx, 'MY_AUDIO_SESSION', 'audio');

    await this.session.setAVMetadata({
      assetId: 'local_mp3_001',
      title: '本地歌曲',
      artist: '未知',
      duration: durationMs,
    });

    // 至少注册 play/pause
    this.session.on('play', () => { /* player.play() */ });
    this.session.on('pause', () => { /* player.pause() */ });

    await this.session.activate(); // 注意：放在 metadata + on(...) 之后

    // 播放开始后上报播放态
    await this.session.setAVPlaybackState({
      state: AVSessionManager.PlaybackState.PLAYBACK_STATE_PLAY,
      position: 0,
      speed: 1.0,
    });
  }

  async updatePosition(posMs: number) {
    if (!this.session) return
    await this.session.setAVPlaybackState({
      state: AVSessionManager.PlaybackState.PLAYBACK_STATE_PLAY,
      position: posMs,
      speed: 1.0,
    });
  }
}

你发我两段信息，我可以直接帮你定位是哪一条没满足

1. 你创建/激活 session 的代码片段（是否把 session 保存成成员变量？activate 放在哪里？）
2. 你有没有调用 setAVPlaybackState，以及你上报的 state/position/duration 分别是多少（日志即可）

Sources:

• https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/avsession-access-scene