{
  "backgroundModes": ["audioPlayback"]
}

{
  "requestPermissions": [
    {
      "name": "ohos.permission.MEDIA_PLAYBACK"
    }
  ]
}

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

// 創(chuàng)建 AVSession
const session = await AVSessionKit.createAVSession(
  context,            // 應(yīng)用上下文
  'AudioSession',     // 會話標(biāo)識
  'audio'             // 會話類型：'audio' 或 'video'
);

// 激活會話
await session.activate();

// 播放
session.on('play', () => {
  // 調(diào)用播放器的播放方法
});

// 暫停
session.on('pause', () => {
  // 調(diào)用播放器的暫停方法
});

// 上一首
session.on('playPrevious', () => {
  // 切換到上一首音頻
});

// 下一首
session.on('playNext', () => {
  // 切換到下一首音頻
});

// 進(jìn)度跳轉(zhuǎn)（seek）
session.on('seek', (seekTime: number) => {
  // seekTime 單位為毫秒，調(diào)用播放器的 seek 方法
});

// 快退
session.on('rewind', () => {
  // 向后跳轉(zhuǎn)指定時(shí)長（如15秒）
});

// 快進(jìn)
session.on('fastForward', () => {
  // 向前跳轉(zhuǎn)指定時(shí)長（如15秒）
});

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

const metadata: AVSessionKit.AVMetadata = {
  assetId: '1001',              // 媒體唯一ID
  title: '音頻標(biāo)題',             // 標(biāo)題
  artist: '作者名稱',            // 作者
  duration: 180000,             // 總時(shí)長（毫秒）
  mediaImage: pixelMapOrUrl     // 封面圖片（PixelMap 對象或圖片URL）
};

session.setAVMetadata(metadata).then(() => {
  // 元數(shù)據(jù)設(shè)置成功
}).catch((err) => {
  // 處理錯(cuò)誤
});

const playbackState: AVSessionKit.AVPlaybackState = {
  state: AVSessionKit.PlaybackState.PLAYBACK_STATE_PLAY,  // 或 PLAYBACK_STATE_PAUSE
  speed: 1.0,
  position: {
    elapsedTime: 30000,   // 當(dāng)前播放位置（毫秒）
    updateTime: new Date().getTime()  // 更新時(shí)間戳
  },
  duration: 180000        // 總時(shí)長（毫秒）
};

session.setAVPlaybackState(playbackState);

const metadata: AVSessionKit.AVMetadata = {
  // ... 其他字段
  mediaImage: 'https://example.com/cover.jpg'
};

import { image } from '@kit.ImageKit';
import { http } from '@kit.NetworkKit';

async function downloadImageAsPixelMap(imageUrl: string): Promise<image.PixelMap | null> {
  try {
    // 1. 通過 HTTP 下載圖片數(shù)據(jù)
    const request = http.createHttp();
    const response = await request.request(imageUrl, {
      method: http.RequestMethod.GET,
      expectDataType: http.HttpDataType.ARRAY_BUFFER
    });
    const arrayBuffer = response.result as ArrayBuffer;
    request.destroy();

    // 2. 創(chuàng)建圖片源
    const imageSource = image.createImageSource(arrayBuffer);
    
    // 3. 創(chuàng)建 PixelMap
    const decodingOptions: image.DecodingOptions = {
      editable: false,
      desiredPixelFormat: 3,  // RGBA_8888
      desiredDynamicRange: image.DecodingDynamicRange.AUTO
    };
    const pixelMap = await imageSource.createPixelMap(decodingOptions);
    imageSource.release();
    
    return pixelMap;
  } catch (err) {
    return null;
  }
}

// 使用 video 類型，播控中心將顯示快退和快進(jìn)按鈕
const session = await AVSessionKit.createAVSession(context, 'AudioSession', 'video');

// 快退 15 秒
function rewind(currentPosition: number): number {
  const REWIND_TIME = 15 * 1000;  // 15秒
  const newPosition = Math.max(0, currentPosition - REWIND_TIME);
  // 調(diào)用播放器 seek 到 newPosition
  // 同步新的播放狀態(tài)到 AVSession
  return newPosition;
}

// 快進(jìn) 15 秒
function fastForward(currentPosition: number, duration: number): number {
  const FORWARD_TIME = 15 * 1000;  // 15秒
  const newPosition = Math.min(duration, currentPosition + FORWARD_TIME);
  // 調(diào)用播放器 seek 到 newPosition
  // 同步新的播放狀態(tài)到 AVSession
  return newPosition;
}

// 注冊快退快進(jìn)監(jiān)聽器
session.on('rewind', () => {
  const newPos = rewind(currentPositionRef.current);
  currentPositionRef.current = newPos;
  syncPlaybackStateToSession(true, newPos, durationRef.current);
});

session.on('fastForward', () => {
  const newPos = fastForward(currentPositionRef.current, durationRef.current);
  currentPositionRef.current = newPos;
  syncPlaybackStateToSession(true, newPos, durationRef.current);
});

function onAppForeground(): void {
  // 檢查播放器狀態(tài)
  if (playerState === 'playing' || playerState === 'paused' || playerState === 'prepared') {
    // 播放器正在工作中，不中斷播放
    return;
  }
  
  // 其他恢復(fù)邏輯...
}

// 切換歌曲時(shí)
function switchToNewAudio(): void {
  // 1. 重置本地狀態(tài)
  currentTime = 0;
  durationTime = 0;
  
  // 2. 設(shè)置新的音頻 URL 并開始播放
  
  // 3. 同步元數(shù)據(jù)到 AVSession
  session.setAVMetadata({
    assetId: newAudio.id,
    title: newAudio.title,
    artist: newAudio.artist,
    duration: newAudio.duration,
    mediaImage: newAudio.coverImage
  });
  
  // 4. 同步播放狀態(tài)，進(jìn)度從 0 開始
  session.setAVPlaybackState({
    state: AVSessionKit.PlaybackState.PLAYBACK_STATE_PLAY,
    speed: 1.0,
    position: {
      elapsedTime: 0,
      updateTime: new Date().getTime()
    },
    duration: newAudio.duration
  });
}

用戶操作                     應(yīng)用側(cè)                    系統(tǒng)播控中心
  │                            │                            │
  ├─ 點(diǎn)擊播放                 │                              │
  │ ─────────────────────────>│                            │
  │                            │ 1. 創(chuàng)建并激活 AVSession    │
  │                            │ 2. setAVMetadata()         │
  │                            │ 3. setAVPlaybackState()    │
  │                            │ ─────────────────────────> │
  │                            │                            │ 顯示音頻信息
  │                            │                            │ 和播放控制按鈕
  │                            │                            │
  ├─ 鎖屏                     │                            │
  │ ──────────────────────────┤───────────────────────────?│
  │                            │                            │ 鎖屏播控中心可見
  │                            │                            │
  │                            │                            │ 用戶點(diǎn)擊快進(jìn)
  │                            │ 4. on('fastForward')       │ <───────────────────
  │                            │ <───────────────────────── │
  │                            │                            │
  │                            │ 5. 播放器 seek +15秒       │
  │                            │ 6. setAVPlaybackState()    │
  │                            │ ─────────────────────────? │ 更新進(jìn)度條顯示
  │                            │                            │
  │                            │                            │ 用戶點(diǎn)擊下一首
  │                            │ 7. on('playNext')          │ <───────────────────
  │                            │ <───────────────────────── │
  │                            │                            │
  │                            │ 8. 切換音頻 + 重置進(jìn)度     │
  │                            │ 9. setAVMetadata()         │
  │                            │ 10. setAVPlaybackState()   │
  │                            │ ─────────────────────────? │ 顯示新音頻信息
  │                            │                            │