アプリへのMusicKitの統合

アプリへのMusicKitの統合

MusicKitを使って、Apple Musicの機能をアプリに組み込みましょう。このセッションでは、認可、サブスクリプション状況の確認、楽曲の選択、再生のコントロール、複数のストアフロント間での楽曲共有といったトピックを取り上げます。Apple Musicカタログや個人用ライブラリを閲覧できる機能を、新しいミュージックピッカーを使ってユーザーに提供する方法を解説します。また、SystemMusicPlayerとApplicationMusicPlayerの違いや、再生の状態をオブザーブする方法も紹介します。

関連する章
- 0:00 - Introduction
- 2:11 - Project setup and authorization
- 7:10 - Music items and music picker
- 10:54 - Music players and playback
- 16:26 - Catalog requests
- 20:11 - Next steps
リソース
関連ビデオ

WWDC23
- SwiftUIにおけるObservationの説明
WWDC22
- Apple Music APIとMusicKitの紹介
- MusicKitでコンテンツをさらに見つける
WWDC 2026へようこそ。私はMusicKitチームのエンジニア、Cathyです！今日は、チームメイトのAlanと私が MusicKitをアプリに統合する方法をご紹介します。
MusicKitはAppleプラットフォーム向けの Swiftフレームワークで、一連のAPIを提供しており、アプリから音楽にアクセスして再生することができます。 Swift並行処理とSwiftUIを念頭に設計されており、 MusicKitはApple Musicとの統合を効率化します。音楽を活かした豊かな体験を構築できるため、 Apple Musicカタログをブラウズして再生したり、ユーザーのメディアライブラリを利用したりできます。アプリから直接。今日は、Alanと私が多くの主要なMusicKitコンセプトをカバーします。私たちが作ったワークアウトアプリを強化しながら。まず、Xcodeの設定方法と音楽アクセスの処理方法を説明します。
次に、MusicKitの音楽アイテムとは何かについて説明し、その選択方法をご紹介します。
Alanは私の音楽選択の作業を引き継ぎ、選択した楽曲を再生できるよう準備します。
最後に、Alanが音楽カタログのリクエストについて詳しく解説し、私たちが作ったアプリをさらにカスタマイズします。では、MusicKit統合に入る前にワークアウトアプリのフローを確認したいと思います。参照用に、完成したサンプルコードはデベロッパードキュメントサイトでご覧いただけます。
アプリを起動して、現在のフローを確認します。バイクワークアウトを開始すると、ストップウォッチが表示された画面が現れ、セッションを終了するボタンも表示されます。
良いスタートですが、ワークアウト中に再生する音楽を選びたいので、 MusicKitを統合したいと思います！
コーディングを始める前に、いくつかの設定を行う必要があります。プロジェクトの設定の一部として。その設定の一つは、デベロッパーポータルでのデベロッパートークンの登録です。 MusicKitリクエストに必要です。デベロッパートークンを登録すると、自動的に生成されます。
自動トークン生成を有効にするには、 App IDを登録するページに移動します。「App Services」タブでMusicKitのチェックボックスがオンになっていることを確認します。
トークンはデベロッパーアカウントに関連付けられているため、 Xcodeで同じアカウントにログインしていることを確認します。では、アプリに戻りましょう！ワークアウト中に再生する音楽を選びたいのですが、音楽を選ぶ前に、 MusicKitが音楽コンテンツにアクセスするための許可が必要です。承認をリクエストするには、 MusicKitのMusicAuthorization requestメソッドを使用します。これは非同期メソッドで、アプリの音楽アクセスが承認されているかどうかを返します。 MusicKitは、許可を求めるアラートをユーザーに表示します。
このアラートの説明文をカスタマイズして、アプリがアクセスをどのように使用するかについての詳細なコンテキストを追加できます。プロジェクト設定で行います。
音楽コンテンツへのアクセス理由を提供するために、 Xcodeプロジェクトの「Signing & Capabilities」タブに移動し、メディアライブラリ機能を追加します。テキストボックスに、アプリがユーザーのミュージックライブラリをどのように使用するかを説明できます。この説明は、許可アラートの下部に表示されます。承認をリクエストすると表示されます。 Apple Musicに未加入のユーザーがコンテンツを聴きたい場合、 Apple Musicカタログの加入する方法を提供したいと思います。 Apple MusicサブスクリプションはMusicKitの使用に必須ではありませんが、サブスクリプションがない場合、購入またはSyncした音楽のみアクセス可能です。アクティブなサブスクリプションがない場合、 MusicKitのサブスクリプションオファービューモディファイアを使用して、アプリを離れることなくApple Musicへの加入機会を提供できます。 .musicSubscriptionOfferはビューモディファイアで、 isPresentedバインディングパラメータを受け入れます。これは、ボタンがタップされたときにこのビューで変化します。
表示されると、サブスクリプションオファーUIはユーザーに手順を示し、 Apple Musicサブスクリプションに素早く登録できます。デベロッパーとして、コミッションを得る可能性があります。アプリを通じてApple Musicに誰かが登録した場合、 Apple Services Performance Partner Programの一環として。このプログラムのための情報を MusicSubscriptionOffer.Options構造体で指定し、ビューモディファイアに渡すことができます。 options構造体ではメッセージ識別子を設定することもでき、表示されるUIを変更できます。私の最終目標は音楽を再生することなので、 messageIdentifierを optionsの.playMusicとして設定します。
メッセージ識別子をカスタマイズして、ユースケースに合わせた異なるUI処理を提供できます。
メインビューでは、@Stateプロパティを宣言する必要があります。サブスクリプション状態を表すものです。ユーザーが未加入の場合にのみサブスクリプションボタンを表示したく、加入可能な状態にある必要があります。サブスクリプション状態を更新するには、承認が付与されたときに実行される.taskを追加できます。ここでは、現在の値を取得し、発生する可能性のある更新もリッスンして、値を適切に設定します。
承認とサブスクリプションが完了したので、サブスクリプションを使用して Apple Musicカタログから音楽を再生できます。ワークアウト中に！まず、再生する楽曲を選ぶ必要があります。具体的には、MusicKitのSongオブジェクトを選択します。 MusicItemsはMusicKit APIを使用するための構成要素で、まずそれについて説明します。次に、ミュージックピッカーを使って音楽アイテムを選ぶ方法を説明します。まず、音楽アイテムについて詳しく見ていきます。
例えばAlbumという音楽アイテムは、値型です。 MusicKitのモデルレイヤーにあります。
各音楽アイテムにはAttributesがあり、シンプルな組み込みプロパティです。例えばAlbumオブジェクトには説明するアトリビュートがあり、アルバムのタイトル、またはアルバムのcontentRatingが何かを説明します。
音楽アイテムにはRelationshipsもあり、関連コンテンツを説明します。例えばAlbumのトラックは、別のMusicKitの音楽アイテム型です。
Associationsも型の関連コンテンツを説明しますが、 Associationsは通常、Relationshipよりも型との結びつきが弱いです。 Albumのアソシエーションの一つは otherVersionsで、他のアルバムのコレクションです。
ここまではAlbumに焦点を当てましたが、他にも多くのMusicKitの音楽アイテム型があり、 Genres、Stations、Playlistsなどがあります。
音楽アイテムとは何かを説明したので、実際に使い始めましょう！ワークアウト中に聴く音楽を選ぶには、ミュージックピッカーを使用できます。 Apple Musicカタログとミュージックライブラリの両方を表示し、統一されたインターフェースで利用できます。ミュージックピッカーは1か所で多くの種類の MusicKitリクエストを活用し、聴きたい音楽をさまざまな方法で見つけることができます。 MusicKitのSongを選ぶには、 .musicPickerというSwiftUIのビューモディファイアを追加します！ベースのボタンはすでにありますが、いくつかの状態変数を追加する必要があります。まず、ピッカーを表示するかどうかのトグルから始めます。次に、selectedSongプロパティは初期の楽曲選択を表します。まだ何も選択していないので、デフォルトでnilにできます。
では、モディファイアを追加できます。
次に、musicPickerButtonボタンをメインビューに追加します。他のボタンを追加した場所に。ミュージックピッカーはサブスクリプションを必要とせず、そのため、サブスクリプションの確認に関わらず表示されます。サブスクリプションがない場合、ピッカーはライブラリの音楽アイテムのみを表示し、ライブラリとカタログの両方ではなく、ライブラリのみとなります。ビルドして実行してみましょう！ Olivia Deanが大好きなので、今のお気に入りの曲を選びます。そのために、検索バーをタップして曲を検索します。目的の結果が見つかったら、プラスボタンをタップできます。曲情報の右側にあるピッカーを閉じます。素晴らしい、バイクライドのために「Lady Lady」が選択されました。でも30分のワークアウトのために、 1曲以上聴きたいと思います。
ピッカーで複数選択をできるようにする必要があります。選択オブジェクトを配列に変更することで。
まず3曲を選びます。アルバムやプレイリスト全体も選択することができ、詳細ページに移動して上部のプラスボタンを押します。曲を選びました。ピッカーを閉じることができます。
音楽を選択したので、再生したいと思います。チームメイトのAlanに引き継ぎます。ワークアウトアプリへの再生機能の追加を説明します。
ありがとう、Cathy。 MusicKitのMusicPlayersを使って音楽を再生しましょう！ MusicKitは2つの異なるプレーヤーを提供します。 SystemMusicPlayerと ApplicationMusicPlayerです。どちらのプレーヤーも MusicPlayerのサブクラスです。 SystemMusicPlayerはシステムのMusicアプリを制御し、 ApplicationMusicPlayerはアプリから再生します。
SystemMusicPlayerでは、キューの設定のみができます。現在再生中のアイテム以外はキューの内容を確認できません。
一方、ApplicationMusicPlayerのキューには完全な読み書きアクセスが可能です。
どちらのプレーヤーも、キューが MusicアプリのRecently Playedに表示されるかどうかを設定でき、どちらも再生状態を設定でき、リピートやシャッフルモードなども設定できます。
最後に、SystemMusicPlayerはシステムのMusicアプリを制御するため、アプリがバックグラウンドになったり終了しても再生が続きます。 ApplicationMusicPlayerで同様のバックグラウンド動作を実現するには、 AudioバックグラウンドMode機能を有効にします。 Xcodeプロジェクトの設定で行います。
キューは再生可能な音楽アイテムのコレクションで構成されており、楽曲などが含まれます。キューはMusicPlayerに設定されます。
MusicPlayerのリピートまたはシャッフルの動作は、その状態で設定できます。
再生を開始するには、MusicPlayerの play()を呼び出します。再生を停止するには、pause()を呼び出します。
まず、MusicPlayerがキューを読み込みます。
次に、MusicPlayerがオーディオアセットを読み込む必要があります。プレーヤーが音楽を出力する前に！
これには少し時間がかかる場合があります。
何を再生するか事前にわかっている場合は、 MusicPlayerをバッファリングしてください。 prepareToPlay()を使用します。これにより、play()を呼び出したときに音楽を出力するまでの時間を短縮できます。
キューは楽曲などの再生可能な音楽アイテムから作成できます。またはアルバムやプレイリストなどのコンテナ型からも作成できます。
コンテナ型に特別なキューイニシャライザを使用すると、ミュージックプレーヤーがコンテナのアイテムを遅延読み込みでき、読み込み時間をさらに短縮できます！ MusicKitを使って音楽を再生すると、通常はユーザーのMusicアプリの再生履歴に表示されます。 affectsListeningHistoryはインスタンスプロパティで、キューが表示されるかどうかを決定します。 MusicアプリのRecently Played シェルフに表示されます。デフォルトは"true"ですが、 MusicアプリのUse Listening History設定を尊重します。プレーヤーを監視して制御するために、どちらのMusicPlayerも再生状態とキューの observableプロパティを持ちます。
ApplicationMusicPlayerには完全なコントロールが可能なキューがあります。これらはSwiftUIビューで直接使用できるobservableクラスです。
Swiftのobservationについて詳しくは、 Discover Observationをご覧ください。 WWDC 2023のSwiftUIセッションで。ワークアウトアプリでは、アートワークをワークアウト中に前面中央に表示したいと思います。現在の曲のタイトルとサブタイトル、そしてコントロールセットも表示します。
現在再生中の曲を取得するには、プレーヤーのキューを参照します。
キューで現在再生中の曲にアートワークがある場合、 MusicKitのArtworkImage SwiftUIビューを使用してアートワークを表示します。
曲情報を表示するには、現在再生中のエントリのタイトルとサブタイトルを使用します。
再生/一時停止を制御するため、ボタンを追加します。 ApplicationMusicPlayerの状態を読み込み、 playbackStatusを確認することで現在再生中かどうかを判断します。
プレーヤーが現在再生中の場合、ボタンは"pause"を呼び出します。それ以外の場合は"play"を呼び出します。
最後に、BackボタンはskipToPreviousEntryを呼び出して前の曲に移動し、 NextボタンではskipToNextEntryを呼び出します。
ミュージックピッカーで、ランニングプレイリストの上部のプラスボタンをタップしてプレイリスト内のすべての曲を選べます。次に、Doneをタップします。最初の曲が再生されています。先ほど追加したArtworkImageが現在再生中の曲を反映しています！ Pauseをタップすると、プレーヤーが一時停止します。 Nextをタップすると、アートワークが次の曲を表示します！
アプリを使用する人にとってもっと便利にしたいと思います。ワークアウトを始めるためにワークアウトビューでタップできる曲を提案することで、すぐに聴き始めることができます！
カタログリクエストにより、アプリがApple Musicをクエリして音楽コンテンツを提供できます。ユーザーのライブラリとは独立して、アプリ向けのキュレーションコンテンツなどを提供します。
MusicKitでは、構造化された音楽カタログリクエストにより Apple Music APIからコンテンツを取得できます。 MusicKitにはいくつかの構造化されたリクエストがあり、特定のフィルターに基づくアイテムの取得、音楽の検索、その他のApple Musicのキュレーションやパーソナライズされたコンテンツがあります！完全なリストと使い方については、 MusicKitドキュメントをご覧ください。
MusicCatalogResourceRequest は特定のリソースに対する構造化されたカタログリクエストです。特定のリソースに対するものです。この例では、楽曲のリクエストを行います。リクエストにはいくつかの設定が含まれており、 optionsなどがあります。リクエストの動作を設定したい場合に使います。 optionsについては後ほど詳しく説明します。
リクエストに、取得したいリレーションシップを指定するプロパティを設定できます。および取得したいアソシエーションこの楽曲リクエストの一部として。例えば、楽曲のArtistsリレーションシップも取得したい場合があります。
また、レスポンスで返すアイテム数の上限を設定できます。
非同期のresponse()メソッドを呼び出すと、 MusicKitがリクエストを実行します。
このメソッドはMusicCatalogResourceResponseを返し、リクエストの結果を含んでいます。強く型付けされたMusicItemCollectionとして。 MusicItemCollectionはMusicKitの型で、音楽アイテムのコレクションを含みます。この例ではSongsが含まれます。
MusicItemCollectionはページネーションに対応しており、リクエストの結果が多すぎる場合、 hasNextBatchが"true"になり、次のページを取得できます。非同期のnextBatch()メソッドを使用します。リソースリクエストを行う際、リソースの利用可能性はアカウントの設定とストアフロントまたはリージョンに依存します。例えば、あるリージョンでリクエストしたリソースが別のリージョンでは異なるIDの同等リソースとして存在する場合があります。また、露骨なコンテンツのリソースには同等のクリーンなリソースがある場合があります。アカウントが露骨なコンテンツを許可していない場合。
楽曲IDのコレクションを入力として受け取る fetchSongsメソッドを作成します。最初のIDはフィーチャー楽曲として扱われます。このメソッドはMusicCatalogResourceRequestを使用して IDに一致する楽曲を検索します。 songIDs引数にある。
findEquivalentsオプションフラグも追加して先ほど説明したリソース等価性の動作を有効にします。次に、response()メソッドを呼び出してコンテンツを取得します。
フィーチャー楽曲を取得するには、 item(for:)メソッドを使用します。入力されたIDコレクションの最初のIDを使って。カタログリクエストは、リクエストされたすべてを返す保証はありません。リソースが利用できない場合などがあります。
最後に、他の楽曲を順番に取得します。
ワークアウトの準備ができました！アプリに戻り、別のワークアウトを開始します。すぐに選べる楽曲のシェルフが表示され、ワークアウトをすぐに始めたいときに素早く選択できます！
これらのアートワークの一つをタップするとすぐに再生が始まります！
MusicKitをアプリに統合するために知っておくべきことはすべてここにあります！ Cathyが説明したように、ミュージックピッカービューモディファイアを採用してアプリで統一された使い慣れた音楽選択体験を提供しましょう！
Apple Musicカタログにはアプリが再生できる豊富なコンテンツがあります。例えば、アプリ体験を豊かにするためのバックグラウンド音楽を追加しましょう！また、他のMusicKit APIもご確認ください。ライブラリコンテンツの閲覧と変更のリクエストなど「Explore more content with MusicKit」でカバーされています。 WWDC2022より。 AndroidやWebへの統合に興味がある場合は、「Meet Apple Music API and MusicKit」をご確認ください。ご視聴ありがとうございました。

4:47 - Presents the Apple Music subscription offer

@State var showSubscriptionOffer = false

let options = MusicSubscriptionOffer.Options(
    messageIdentifier: .playMusic
)

@ViewBuilder
var musicSubsriptionButton: some View {
    Button("Subscribe to Apple Music", systemImage: "music.note") {
        showSubscriptionOffer = true
    }
    .musicSubscriptionOffer(isPresented: $showSubscriptionOffer, options: options)
}

5:59 - Adds subscription button to main view

@State var subscription: MusicSubscription?

var body: some View {
  	VStack {
        // ...
        if let subscription, subscription.canBecomeSubscriber {
            musicSubscriptionButton
        }
    }
    .task(id: isAuthorized) {
	      self.subscription = try? await MusicSubscription.current
        for await subscription in MusicSubscription.subscriptionUpdates {
            self.subscription = subscription
        }
    }
}

8:48 - Add .musicPicker() modifier

@State var showMusicPicker = false
@State var selectedSong: Song? = nil

@ViewBuilder
var musicPickerButton: some View {
    Button("Pick some Music", systemImage: "music.note.list") {
        showMusicPicker = true
    }
    .musicPicker(isPresented: $showMusicPicker, selection: $selectedSong)
}

var body: some View {
    VStack {
        if let subscription, subscription.canBecomeSubscriber {
            musicSubscriptionButton
        }
        musicPickerButton
    }
}

14:49 - Artwork

@State var queue = ApplicationMusicPlayer.shared.queue

var body: some View {
    VStack {
        if let artwork = queue.currentEntry?.artwork {
            ArtworkImage(artwork, width: 200, height: 200)
        } else {
            // Placeholder artwork
            RoundedRectangle(cornerRadius: 16)
                .fill(.quaternary)
                .frame(width: 200, height: 200)
        }
    }
}

15:06 - Current entry info

@State var queue = ApplicationMusicPlayer.shared.queue

var body: some View {
    VStack {
        // ...
        if let currentSong = queue.currentEntry {
            Text(currentSong.title)
                .font(.title3.bold())
              
            if let subtitle = currentSong.subtitle {
                Text(subtitle)
                    .font(.subheadline)
                    .foregroundStyle(.secondary)
            }
        }
    }
}

15:14 - Playback controls (play, pause)

let player = ApplicationMusicPlayer.shared
@State var state = ApplicationMusicPlayer.shared.state

var isPlaying: Bool {
    state.playbackStatus == .playing
}

var playPause: some View {
    Button (
        isPlaying ? "Pause": "Play",
        systemImage: isplaying ? "pause.fill" : "play.fill"
    ) {
        if isPlaying {
            player.pause()
        } else {
            Task {
                try await player.play()
            }
        }
    }
}

15:38 - Playback controls (next, previous)

let player = ApplicationMusicPlayer.shared

var controls: some View {
    HStack {
        Button("Back", systemImage: "backward.fill") {
            Task {
                try await player.skipToPreviousEntry()
            }
        }
        // ...
        Button("Next", systemImage: "forward.fill") {
            Task {
                try await player.skipToNextEntry()
            }
        }
    }
}

18:58 - Music catalog resource request

func fetchSongs(songIDs: [MusicItemID]) async throws -> (featured: Song?, other: [Song]) {
    var request = MusicCatalogResourceRequest‹Song>(matching: \.id, memberOf: songIDs)
    request.options = [.findEquivalents]
    
    let response = try await request.response()
    
    let featuredSongID = songIDs[0]
    let featuredSong = response.item(for: featuredSongID)
    
    let others: [Song] = songIDs[1...].compactMap { songID in
        return response.item(for: songID)
    }
    
    return (featuredSong, others)
}

- 0:00 - Introduction
- An introduction to MusicKit and an overview of how to build a music-enhanced workout app using Swift concurrency and SwiftUI.
- 2:11 - Project setup and authorization
- Learn how to configure your Xcode project with the necessary capabilities, request music library authorization, and present Apple Music subscription offers to users.
- 7:10 - Music items and music picker
- Explore the properties and relationships of MusicKit music items, and use the music picker view modifier to let users browse and select songs from the Apple Music catalog or their own library.
- 10:54 - Music players and playback
- Dive into using SystemMusicPlayer and ApplicationMusicPlayer. Discover how to set up playback queues, observe playback state, and build UI controls for playback in SwiftUI.
- 16:26 - Catalog requests
- Use structured catalog requests like MusicCatalogResourceRequest to fetch curated Apple Music content, and learn how to handle localization and content equivalency.
- 20:11 - Next steps
- A quick recap of MusicKit capabilities and pointers to related sessions for further learning.

「今すぐ始める」を詳しく見る

最新情報

プラットフォームを詳しく見る

特集

テクノロジーを詳しく見る

特集

コミュニティを詳しく見る

特集

ドキュメントを詳しく見る

リリースノート

ダウンロードを詳しく見る

特集

サポートを詳しく見る

特集

クイックリンク

関連する章

リソース

関連ビデオ

WWDC23

WWDC22