axiom-now-playing-musickit

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

MusicKit Integration (Apple Music)

MusicKit 集成（Apple Music）

Time cost: 5-10 minutes

耗时: 5-10分钟

Key Insight

核心要点

MusicKit's ApplicationMusicPlayer automatically publishes to MPNowPlayingInfoCenter. You don't need to manually update Now Playing info when playing Apple Music content.

MusicKit的ApplicationMusicPlayer会自动向MPNowPlayingInfoCenter发布信息。 播放Apple Music内容时，你无需手动更新正在播放信息。

What's Automatic

自动处理的内容

When using

ApplicationMusicPlayer

Track title, artist, album
Artwork (Apple's album art)
Duration and elapsed time
Playback rate (playing/paused state)

The system handles all MPNowPlayingInfoCenter updates for you.

使用

ApplicationMusicPlayer

时：

曲目标题、艺术家、专辑
封面图（Apple提供的专辑封面）
时长和已播放时间
播放速率（播放/暂停状态）

系统会为你处理所有MPNowPlayingInfoCenter的更新。

What's NOT Automatic

非自动处理的内容

Custom metadata (chapter markers, custom artist notes)
Remote command customization beyond standard controls
Mixing MusicKit content with your own content

自定义元数据（章节标记、自定义艺术家注释）
超出标准控制范围的远程命令自定义
将MusicKit内容与自有内容混合播放

GOOD Code (MusicKit Content)

优质代码示例（MusicKit内容）

swift

import MusicKit

@MainActor
class MusicKitPlayer {
    private let player = ApplicationMusicPlayer.shared

    func play(song: Song) async throws {
        // ✅ Just play - MPNowPlayingInfoCenter updates automatically
        player.queue = [song]
        try await player.play()

        // ❌ DO NOT manually set nowPlayingInfo here
        // MPNowPlayingInfoCenter.default().nowPlayingInfo = [...] // WRONG!
    }
}

swift

import MusicKit

@MainActor
class MusicKitPlayer {
    private let player = ApplicationMusicPlayer.shared

    func play(song: Song) async throws {
        // ✅ Just play - MPNowPlayingInfoCenter updates automatically
        player.queue = [song]
        try await player.play()

        // ❌ DO NOT manually set nowPlayingInfo here
        // MPNowPlayingInfoCenter.default().nowPlayingInfo = [...] // WRONG!
    }
}

Hybrid Apps (Own Content + Apple Music)

混合应用（自有内容 + Apple Music）

If your app plays both Apple Music and your own content:

swift

import MusicKit

@MainActor
class HybridPlayer {
    private let musicKitPlayer = ApplicationMusicPlayer.shared
    private var avPlayer: AVPlayer?
    private var currentSource: ContentSource = .none

    enum ContentSource {
        case none
        case appleMusic      // MusicKit handles Now Playing
        case ownContent  // We handle Now Playing
    }

    func playAppleMusicSong(_ song: Song) async throws {
        // Switch to MusicKit
        avPlayer?.pause()
        currentSource = .appleMusic

        musicKitPlayer.queue = [song]
        try await musicKitPlayer.play()
        // ✅ MusicKit handles Now Playing automatically
    }

    func playOwnContent(_ url: URL) {
        // Switch to AVPlayer
        musicKitPlayer.pause()
        currentSource = .ownContent

        avPlayer = AVPlayer(url: url)
        avPlayer?.play()

        // ✅ Manually update Now Playing (Patterns 1-4)
        updateNowPlayingForOwnContent()
    }

    private func updateNowPlayingForOwnContent() {
        var nowPlayingInfo = [String: Any]()
        nowPlayingInfo[MPMediaItemPropertyTitle] = "My Track"
        // ... rest of manual setup from Patterns 1-4
        MPNowPlayingInfoCenter.default().nowPlayingInfo = nowPlayingInfo
    }
}

如果你的应用同时播放Apple Music和自有内容：

swift

import MusicKit

@MainActor
class HybridPlayer {
    private let musicKitPlayer = ApplicationMusicPlayer.shared
    private var avPlayer: AVPlayer?
    private var currentSource: ContentSource = .none

    enum ContentSource {
        case none
        case appleMusic      // MusicKit handles Now Playing
        case ownContent  // We handle Now Playing
    }

    func playAppleMusicSong(_ song: Song) async throws {
        // Switch to MusicKit
        avPlayer?.pause()
        currentSource = .appleMusic

        musicKitPlayer.queue = [song]
        try await musicKitPlayer.play()
        // ✅ MusicKit handles Now Playing automatically
    }

    func playOwnContent(_ url: URL) {
        // Switch to AVPlayer
        musicKitPlayer.pause()
        currentSource = .ownContent

        avPlayer = AVPlayer(url: url)
        avPlayer?.play()

        // ✅ Manually update Now Playing (Patterns 1-4)
        updateNowPlayingForOwnContent()
    }

    private func updateNowPlayingForOwnContent() {
        var nowPlayingInfo = [String: Any]()
        nowPlayingInfo[MPMediaItemPropertyTitle] = "My Track"
        // ... rest of manual setup from Patterns 1-4
        MPNowPlayingInfoCenter.default().nowPlayingInfo = nowPlayingInfo
    }
}

Common Mistake

常见错误

swift

// ❌ WRONG - Overwrites MusicKit's automatic Now Playing data
func playAppleMusicSong(_ song: Song) async throws {
    try await ApplicationMusicPlayer.shared.play()

    // ❌ This clears MusicKit's Now Playing info!
    var nowPlayingInfo = [String: Any]()
    nowPlayingInfo[MPMediaItemPropertyTitle] = song.title
    MPNowPlayingInfoCenter.default().nowPlayingInfo = nowPlayingInfo
}

// ✅ CORRECT - Let MusicKit handle it
func playAppleMusicSong(_ song: Song) async throws {
    try await ApplicationMusicPlayer.shared.play()
    // That's it! MusicKit publishes Now Playing automatically.
}

swift

// ❌ WRONG - Overwrites MusicKit's automatic Now Playing data
func playAppleMusicSong(_ song: Song) async throws {
    try await ApplicationMusicPlayer.shared.play()

    // ❌ This clears MusicKit's Now Playing info!
    var nowPlayingInfo = [String: Any]()
    nowPlayingInfo[MPMediaItemPropertyTitle] = song.title
    MPNowPlayingInfoCenter.default().nowPlayingInfo = nowPlayingInfo
}

// ✅ CORRECT - Let MusicKit handle it
func playAppleMusicSong(_ song: Song) async throws {
    try await ApplicationMusicPlayer.shared.play()
    // That's it! MusicKit publishes Now Playing automatically.
}

When to Use Manual Updates with MusicKit

何时在MusicKit中使用手动更新

Only override MPNowPlayingInfoCenter if:

You're mixing in additional metadata (e.g., podcast chapter markers)
You're displaying custom content alongside Apple Music
You have a specific reason to replace MusicKit's automatic behavior

Default: Let MusicKit manage Now Playing automatically.

仅在以下情况覆盖MPNowPlayingInfoCenter：

你需要混入额外元数据（如播客章节标记）
你要在Apple Music旁显示自定义内容
你有特定理由替换MusicKit的自动行为

默认原则：让MusicKit自动管理正在播放信息。

Resources

参考资源

Skills: axiom-now-playing, axiom-now-playing-carplay