HarmonyOS鸿蒙Next中求问怎么离线获取到当前播控中心在播放的音乐信息

在HarmonyOS Next中，可通过AVSessionManager获取当前播放的音乐信息。使用getActiveAVSession()获取活跃的AVSession，再通过AVSession的AVMetadata属性获取音乐元数据，如标题、艺术家等。

在HarmonyOS Next中，要离线获取当前播控中心正在播放的音乐信息，核心是使用AVSession（音视频会话）框架。这是系统统一的媒体播放控制与信息获取接口。

主要实现步骤与关键API如下：

1. 获取AVSessionManager 首先获取会话管理器的实例。

   import avSession from '@ohos.multimedia.avsession';
   let avSessionManager = avSession.getAVSessionManager();
   

2. 获取当前系统的音频焦点会话 播控中心管理的播放会话通常持有音频焦点。通过getCurrentAVSession方法可以获取到当前具有音频焦点的会话，这通常就是正在播放的媒体应用会话。

   import avSession from '@ohos.multimedia.avsession';
   let session: avSession.AVSession | null = null;
   avSession.getAVSessionManager().getCurrentAVSession(avSession.AVSession.AudioFocusType.ALL).then((currentSession: avSession.AVSession) => {
     session = currentSession;
   }).catch((err: BusinessError) => {
     console.error(`Failed to get current session. Code: ${err.code}, message: ${err.message}`);
   });
   

3. 获取会话的元数据（AVMetadata） 获取到AVSession对象后，可以通过其AVSessionController来读取详细的元数据，其中就包含音乐信息。

   if (session) {
     let controller: avSession.AVSessionController = await avSessionManager.createController(session.sessionId);
     let avMetadata: avSession.AVMetadata = controller.getAVMetadata();
     // 从avMetadata中提取音乐信息
     let title: string = avMetadata.title; // 歌曲标题
     let artist: string = avMetadata.artist; // 艺术家
     let album: string = avMetadata.album; // 专辑
     let duration: number = avMetadata.duration; // 总时长（毫秒）
     // ... 其他属性如writer, composer等
   }
   

4. 获取播放状态 同时，可以获取当前的播放状态，如是否正在播放、进度、速度等。

   let avPlaybackState: avSession.AVPlaybackState = controller.getAVPlaybackState();
   let isPlaying: boolean = (avPlaybackState.state === avSession.PlaybackState.PLAYING);
   let currentPosition: number = avPlaybackState.position; // 当前播放位置（毫秒）
   let playbackSpeed: number = avPlaybackState.speed; // 播放速度
   

关键注意事项：

• 权限声明：在应用的module.json5配置文件中，需要声明ohos.permission.MANAGE_MEDIA_RESOURCES权限。该权限为system_core级别，通常需要特殊申请。

  {
    "module": {
      "requestPermissions": [
        {
          "name": "ohos.permission.MANAGE_MEDIA_RESOURCES",
          "reason": "$string:reason",
          "usedScene": {
            "abilities": [
              "EntryAbility"
            ],
            "when": "always"
          }
        }
      ]
    }
  }
  

• “离线”含义：此方法获取的是设备本地当前活跃的媒体会话信息，不依赖于网络，符合“离线获取”的要求。
• 会话有效性：获取到的AVSession对象可能因为播放停止或应用退出而失效，在访问其属性前需做好空值判断。可以监听会话的销毁事件。
• 后台限制：若应用在后台长时间运行并监听会话变化，需注意系统的后台任务管理策略。

通过上述AVSession框架的接口，你可以稳定地获取到由播控中心统一管理的当前播放音乐的标题、艺人、专辑、播放进度等核心信息。