Introducing MusicKit. Media #WWDC17. Tim Parthemore, MusicKit Services Joel Lopes Da Silva, ios Music

Transcription

1 Session Media #WWDC17 Introducing MusicKit 502 Tim Parthemore, MusicKit Services Joel Lopes Da Silva, ios Music 2017 Apple Inc. All rights reserved. Redistribution or public display not permitted without written permission from Apple.

2 Apple Music Content Artists

3 Apple Music Content Artists Albums

4 Apple Music Content Artists Albums Playlists

5 Apple Music Content Artists Albums Playlists Curators

6 Apple Music Discovery Search

7 Apple Music Discovery Search Charts

8 Apple Music Discovery Search Charts Recommendations

9 MusicKit

10 MusicKit ios Frameworks

11 MusicKit ios Frameworks HTTPS Apple Music API Catalog Services Personalized Services

12 Apple Music API Tim Parthemore, MusicKit Services

13 Request format Resource representations and relationships Limits and pagination Demo Personalized services API Access

14 Apple Music API Catalog

15 Apple Music API Catalog Versioned

16 Apple Music API Catalog Versioned

17 Apple Music API Catalog Versioned Storefront scopes the catalog

18 Apple Music API Catalog /{storefront}/{api} Versioned Storefront scopes the catalog

19 Apple Music API Catalog /{storefront}/{api}?[params] Versioned Storefront scopes the catalog

20 Apple Music API Catalog /{storefront}/{api}?[params] Versioned Storefront scopes the catalog Localized

21 Apple Music API Catalog /{storefront}/{api}?[params] Versioned Storefront scopes the catalog Localized Limits and pagination

22 Apple Music API Catalog /{storefront}/{api}?[params] Versioned Storefront scopes the catalog Localized Limits and pagination Requires a developer token

23 Apple Music API Resource representations id type {"data": [{ "id": " ", "type": "albums", "href": "/v1/catalog/us/albums/ "}]} href

24 Apple Music API Resource representations id type href attributes {"data": [{ "id": " ", "type": "albums", "href": "/v1/catalog/us/albums/ "}]} "/v1/catalog/us/albums/ ", "attributes": { "artwork": { }, "artistname": "Khalid", "discnumber": 1, "genrenames": "playparams": ["R&B/Soul", { }, "Music"], "releasedate": " ", "tracknumber": 15}}]}

25 Apple Music API Resource representations id type href attributes relationships {"data": [{ "id": " ", "type": "albums", "href": "/v1/catalog/us/albums/ "}]} "/v1/catalog/us/albums/ ", "attributes": { }, "relationships": "artwork": { }, { "artistname": "tracks": "Khalid", { "discnumber": "data": 1, [{ },,{ }], "href": /v1/ /albums/ /tracks "/v1/ /albums/ /tracks" }, "genrenames": "playparams": "artists": ["R&B/Soul", { }, { "Music"], "releasedate": "data": " ", [{ }], "tracknumber": "href": 15}}]} /v1/ /albums/ /artists }}}]} "/v1/ /albums/ /artists"}}}]}

26 Apple Music API Resource relationships

27 Apple Music API Resource relationships Album Resource id type href attributes

28 Apple Music API Resource relationships Album Resource tracks id type href attributes

29 Apple Music API Resource relationships Album Resource tracks id type artists href attributes

30 Apple Music API Resource relationships Album Resource tracks id type artists href attributes genres

31 Apple Music API Resource relationships Album Resource id Attributes included tracks Song id type href attributes type href artists attributes genres

32 Apple Music API Resource relationships Album Resource id type href Attributes included tracks Identifiers only artists Song id type href attributes Artist id type href attributes genres

33 Apple Music API Resource relationships Album Resource id type href attributes Attributes included tracks Identifiers only artists Omitted genres Song id type href attributes Artist id type href

34 "relationships": { "tracks": {"data": [{"id": " ", "type": "songs", "href": "/v1/catalog/us/songs/ ", "attributes": { }}, {"id": " ", "type": "songs", "href": "/v1/catalog/us/songs/ " "attributes": { }}], "href": "/v1/catalog/us/albums/ /tracks"}, "artists": {"data": [{"id": " ", "type": "artists", "href": "/v1/catalog/us/artists/ "}], "href": "/v1/catalog/us/albums/ /artists"}}

35 "relationships": { "tracks": {"data": [{"id": " ", "type": "songs", "href": "/v1/catalog/us/songs/ ", "attributes": { }}, {"id": " ", "type": "songs", "href": "/v1/catalog/us/songs/ " "attributes": { }}], "href": "/v1/catalog/us/albums/ /tracks"}, "artists": {"data": [{"id": " ", "type": "artists", "href": "/v1/catalog/us/artists/ "}], "href": "/v1/catalog/us/albums/ /artists"}}

36 "relationships": { "tracks": {"data": [{"id": " ", "type": "songs", "href": "/v1/catalog/us/songs/ ", "attributes": { }}, {"id": " ", "type": "songs", "href": "/v1/catalog/us/songs/ " "attributes": { }}], "href": "/v1/catalog/us/albums/ /tracks"}, "artists": {"data": [{"id": " ", "type": "artists", "href": "/v1/catalog/us/artists/ "}], "href": "/v1/catalog/us/albums/ /artists"}}

37 "relationships": { "tracks": { }, "artists": {"data": [{ "id": " ", "type": "artists", "href": "/v1/catalog/us/artists/ ", "attributes": { "genrenames": ["R&B/Soul","Hip-Hop/Rap", "Rap"] "isgroup": false, "name": "Khalid", } }], "href": "/v1/catalog/us/albums/ /artists"}}

38 "relationships": { "tracks": { }, "artists": {"data": [{ "id": " ", "type": "artists", "href": "/v1/catalog/us/artists/ ", "attributes": { "genrenames": ["R&B/Soul","Hip-Hop/Rap", "Rap"] "isgroup": false, "name": "Khalid", } }], "href": "/v1/catalog/us/albums/ /artists"}}

39 "relationships": { "tracks": { }, "artists": { } "genres": {"data": [{"id": "14", }} "type": "genres", "href": "/v1/catalog/us/genres/14", "attributes": { "name": "Pop"}}, {"id": "34", "type": "genres", "href": "/v1/catalog/us/genres/34", "attributes": { "name": "Music"}], "href": "/v1/catalog/us/albums/ /genres"

40 "relationships": { "tracks": { }, "artists": { } "genres": {"data": [{"id": "14", }} "type": "genres", "href": "/v1/catalog/us/genres/14", "attributes": { "name": "Pop"}}, {"id": "34", "type": "genres", "href": "/v1/catalog/us/genres/34", "attributes": { "name": "Music"}], "href": "/v1/catalog/us/albums/ /genres"

41 Apple Music API Limits and pagination

42 Apple Music API Limits and pagination Song 9 Song 8 Song 7 id Song 6 id Song 5 id type Song 4 id type Song 3 id type Song 2 id href type Song 1 id href type id href type attributes id href type attributes href type attributes href type attributes href attributes href attributes href attributes attributes attributes

43 Apple Music API Limits and pagination

44 Apple Music API Limits and pagination

45 Apple Music API Limits and pagination Song 2 Song 1 id id type type href href attributes attributes

46 Apple Music API Limits and pagination Song 2 Song 1 id id type type href href attributes attributes next

47 Apple Music API Limits and pagination Song 2 Song 1 id id type type href href attributes attributes next /v1/catalog/us/albums/ /tracks?offset=2

48 Apple Music API Limits and pagination

49 Apple Music API Limits and pagination Song 9 Song 8 Song 7 id Song 6 id Song 5 id type Song 4 id type Song 3 id type id href type id href type href type attributes href type attributes href attributes href attributes href attributes attributes attributes

50 Apple Music API Limits and pagination

51 Apple Music API Limits and pagination

52 Apple Music API Limits and pagination Song 4 Song 3 id id type type href href attributes attributes

53 Apple Music API Limits and pagination Song 4 Song 3 id id type type href href attributes attributes next

54 Apple Music API Limits and pagination Song 4 Song 3 id id type type href href attributes attributes next /v1/catalog/us/albums/ /tracks?offset=4

55 {"data": [{ "attributes": { }, "href": "/v1/catalog/us/songs/ ", "id": " ", "relationships": { } "type": "songs" }, { "attributes": { }, "href": "/v1/catalog/us/songs/ ", "id": " ", "relationships": { }, "type": "songs" }], "next": "/v1/catalog/us/albums/ /tracks?offset=2"}

56 Apple Music API Search albums artists songs playlists Album Artists Song Playlist id id id id type type type type href href href href attributes attributes attributes attributes

57 Apple Music API Search albums artists songs playlists Album Artists Song Playlist id id id id type type type type href href href href attributes attributes attributes attributes

58 Apple Music API Search albums Album id type href attributes

59 Demo Apple Music Catalog Search Joel Lopes Da Silva, ios Music

60 Apple Music API Personalized User must have an Apple Music Subscription Required tokens Developer token Music user token

61 API Access Requirements

62 API Access Requirements Apple Developer Program membership

63 API Access Requirements Apple Developer Program membership MusicKit private key

64 API Access Requirements Apple Developer Program membership MusicKit private key Developer token JSON Web Token (RFC 7519) Required in the Authorization header for every Apple Music API request

65 API Access Requirements Apple Developer Program membership MusicKit private key Developer token JSON Web Token (RFC 7519) Required in the Authorization header for every Apple Music API request Security Protect your MusicKit private key Recommend dynamically generating developer tokens

66 API Access More about the developer token

67 API Access More about the developer token Required Headers - Encryption Algorithm (alg), Key Identifier (kid) { } "alg": "ES256", "kid": "ABC123DEFG"

68 API Access More about the developer token Required Headers - Encryption Algorithm (alg), Key Identifier (kid) Required Claims - Issuer/Team ID (iss), Issued at (iat), Expiration (exp) { } { } "alg": "ES256", "kid": "ABC123DEFG" "iss": "DEF123GHIJ", "iat": , "exp":

69 Using MusicKit on ios Joel Lopes Da Silva, ios Music

70 Get access to Apple Music API Allow users to subscribe Play subscription and library content

71 Get access to Apple Music API Allow users to subscribe Play subscription and library content

72 Privacy and User Consent Most users are already signed in No need to authenticate to use MusicKit Requires user consent User consent is per ios device and per app

73

74 Requesting User Consent Needed to access device library or get the music user token Reading authorization status will not prompt Requesting will prompt unless already authorized

75 Requesting User Consent Needed to access device library or get the music user token Reading authorization status will not prompt Requesting will prompt unless already authorized SKCloudServiceController.requestAuthorization { (status: SKCloudServiceAuthorizationStatus) in switch status { case.authorized: case.denied,.restricted: case.notdetermined: } }

76 Fetching Subscription Status

77 Fetching Subscription Status Actual status may be complex

78 Fetching Subscription Status Actual status may be complex We expose three capabilities: Music catalog playback Add to icloud Music Library Can become subscriber

79 Fetching Subscription Status Actual status may be complex We expose three capabilities: Music catalog playback Add to icloud Music Library Can become subscriber Check each capability before corresponding app action

80 Fetching Subscription Status Requires user consent or else you get an error let controller = SKCloudServiceController() controller.requestcapabilities { (capabilities: SKCloudServiceCapability, error: Error?) in let canplay = capabilities.contains(.musiccatalogplayback) let canadd = capabilities.contains(.addtocloudmusiclibrary) let cansubscribe = capabilities.contains(.musiccatalogsubscriptioneligible) }

81 Fetching Storefront Country Code Content identifiers vary across storefronts let controller = SKCloudServiceController() controller.requeststorefrontcountrycode { (countrycode: String?, error: Error?) in if let storefrontcountrycode = countrycode { } }

82 Fetching Storefront Country Code Content identifiers vary across storefronts let controller = SKCloudServiceController() controller.requeststorefrontcountrycode { (countrycode: String?, error: Error?) in if let storefrontcountrycode = countrycode { var topsongsurlcomponents = URLComponents() topsongsurlcomponents.scheme = "https" topsongsurlcomponents.host = "api.music.apple.com" topsongsurlcomponents.path = "/v1/catalog/\(storefrontcountrycode)/charts" topsongsurlcomponents.queryitems = [URLQueryItem(name: "types", value: "songs")] } }

83 Fetching Storefront Country Code Content identifiers vary across storefronts let controller = SKCloudServiceController() controller.requeststorefrontcountrycode { (countrycode: String?, error: Error?) in if let storefrontcountrycode = countrycode { var topsongsurlcomponents = URLComponents() topsongsurlcomponents.scheme = "https" topsongsurlcomponents.host = "api.music.apple.com" topsongsurlcomponents.path = "/v1/catalog/\(storefrontcountrycode)/charts" topsongsurlcomponents.queryitems = [URLQueryItem(name: "types", value: "songs")] } }

84 Fetching Music User Token From your developer token You should cache the token, but don t transfer it across devices Refetch if you get a Forbidden status code (403) from Apple Music API

85 Fetching Music User Token let developertoken = "ey " let controller = SKCloudServiceController() controller.requestusertoken(fordevelopertoken: developertoken) { (usertoken: String?, error: Error?) in if let musicusertoken = usertoken { } }

86 Fetching Music User Token let developertoken = "ey " let controller = SKCloudServiceController() controller.requestusertoken(fordevelopertoken: developertoken) { (usertoken: String?, error: Error?) in if let musicusertoken = usertoken { var request = URLRequest(url: recentlyplayedurl) request.setvalue("bearer \(developertoken)", forhttpheaderfield: "Authorization") request.setvalue(musicusertoken, forhttpheaderfield: "Music-User-Token") } }

87 Fetching Music User Token let developertoken = "ey " let controller = SKCloudServiceController() controller.requestusertoken(fordevelopertoken: developertoken) { (usertoken: String?, error: Error?) in if let musicusertoken = usertoken { var request = URLRequest(url: recentlyplayedurl) request.setvalue("bearer \(developertoken)", forhttpheaderfield: "Authorization") request.setvalue(musicusertoken, forhttpheaderfield: "Music-User-Token") } }

88 Get access to Apple Music API Allow users to subscribe Play subscription and library content

89

90 When to Show the Subscription View? Only if.musiccatalogplayback capability is disabled and.musiccatalogsubscriptioneligible is enabled

91 Configure the Subscription View Choose the main message Optional:.messageIdentifier Default:.join

92 Configure the Subscription View Choose the main message Optional:.messageIdentifier Default:.join Other values:

93 Configure the Subscription View Choose the main message Optional:.messageIdentifier Default:.join Other values:.connect

94 Configure the Subscription View Choose the main message Optional:.messageIdentifier Default:.join Other values:.connect.addmusic

95 Configure the Subscription View Choose the main message Optional:.messageIdentifier Default:.join Other values:.connect.addmusic.playmusic

96 Configure the Subscription View Contextual offer Optional:.iTunesItemIdentifier Type: String Supported content types: songs albums playlists radio stations

97 Configure the Subscription View Other options Key Value.action.subscribe Required.affiliateToken String Optional.campaignToken String Optional

98 // Showing Subscription View let setupviewcontroller = SKCloudServiceSetupViewController() setupviewcontroller.delegate = self let setupoptions: [SKCloudServiceSetupOptionsKey: Any] = [.action: SKCloudServiceSetupAction.subscribe,.messageIdentifier: SKCloudServiceSetupMessageIdentifier.playMusic ] setupviewcontroller.load(options: setupoptions) { (didsucceedloading: Bool, error: Error?) in if didsucceedloading { self.present(setupviewcontroller, animated: true, completion: nil) } })

99 // Showing Subscription View let setupviewcontroller = SKCloudServiceSetupViewController() setupviewcontroller.delegate = self let setupoptions: [SKCloudServiceSetupOptionsKey: Any] = [.action: SKCloudServiceSetupAction.subscribe,.messageIdentifier: SKCloudServiceSetupMessageIdentifier.playMusic ] setupviewcontroller.load(options: setupoptions) { (didsucceedloading: Bool, error: Error?) in if didsucceedloading { self.present(setupviewcontroller, animated: true, completion: nil) } })

100 // Showing Subscription View let setupviewcontroller = SKCloudServiceSetupViewController() setupviewcontroller.delegate = self let setupoptions: [SKCloudServiceSetupOptionsKey: Any] = [.action: SKCloudServiceSetupAction.subscribe,.messageIdentifier: SKCloudServiceSetupMessageIdentifier.playMusic ] setupviewcontroller.load(options: setupoptions) { (didsucceedloading: Bool, error: Error?) in if didsucceedloading { self.present(setupviewcontroller, animated: true, completion: nil) } })

101 // Showing Subscription View let setupviewcontroller = SKCloudServiceSetupViewController() setupviewcontroller.delegate = self let setupoptions: [SKCloudServiceSetupOptionsKey: Any] = [.action: SKCloudServiceSetupAction.subscribe,.messageIdentifier: SKCloudServiceSetupMessageIdentifier.playMusic ] setupviewcontroller.load(options: setupoptions) { (didsucceedloading: Bool, error: Error?) in if didsucceedloading { self.present(setupviewcontroller, animated: true, completion: nil) } })

102 // Showing Subscription View let setupviewcontroller = SKCloudServiceSetupViewController() setupviewcontroller.delegate = self let setupoptions: [SKCloudServiceSetupOptionsKey: Any] = [.action: SKCloudServiceSetupAction.subscribe,.messageIdentifier: SKCloudServiceSetupMessageIdentifier.playMusic ] setupviewcontroller.load(options: setupoptions) { (didsucceedloading: Bool, error: Error?) in if didsucceedloading { self.present(setupviewcontroller, animated: true, completion: nil) } })

103 Get access to Apple Music API Allow users to subscribe Play subscription and library content

104 Two Players MPMusicPlayerController systemmusicplayer applicationqueueplayer

105 Two Players MPMusicPlayerController systemmusicplayer applicationqueueplayer Example

106 Two Players MPMusicPlayerController systemmusicplayer applicationqueueplayer Example Social networking app

107 Two Players MPMusicPlayerController systemmusicplayer applicationqueueplayer Example Social networking app Fitness app

108 Two Players MPMusicPlayerController systemmusicplayer applicationqueueplayer Example Social networking app Fitness app Now Playing info reporting Remote commands handling

109 Two Players MPMusicPlayerController systemmusicplayer applicationqueueplayer Example Social networking app Fitness app Now Playing info reporting Remote commands handling Now Playing app Music app Your app

110 Two Players MPMusicPlayerController systemmusicplayer applicationqueueplayer Example Social networking app Fitness app Now Playing info reporting Remote commands handling Now Playing app Music app Your app Playback queue ownership Remote-controlling the Music app Your app owns the queue

111 Two Players MPMusicPlayerController systemmusicplayer applicationqueueplayer Example Social networking app Fitness app Now Playing info reporting Remote commands handling Now Playing app Music app Your app Playback queue ownership Remote-controlling the Music app Your app owns the queue Set queue / Play next / Play later

112 Two Players MPMusicPlayerController systemmusicplayer applicationqueueplayer Example Social networking app Fitness app Now Playing info reporting Remote commands handling Now Playing app Music app Your app Playback queue ownership Remote-controlling the Music app Your app owns the queue Set queue / Play next / Play later Insert items in the middle / Remove items

113 Queue Descriptors Data Use Case

114 Queue Descriptors Data Use Case Media Item MPMediaItem MPMediaItemCollection Device library queries (MPMediaQuery) Media picker

115 Queue Descriptors Data Use Case Media Item MPMediaItem MPMediaItemCollection Device library queries (MPMediaQuery) Media picker Store Queue Store IDs (String) Catalog content (e.g. catalog search)

116 Queue Descriptors Data Use Case Media Item MPMediaItem MPMediaItemCollection Device library queries (MPMediaQuery) Media picker Store Queue Store IDs (String) Catalog content (e.g. catalog search) Play Parameters Dictionaries Personalized content (e.g. recently played)

117 let player = MPMusicPlayerController.systemMusicPlayer player.repeatmode =.all let album: MPMediaItemCollection =... let albumqueuedescriptor = MPMusicPlayerMediaItemQueueDescriptor(itemCollection: album) albumqueuedescriptor.startitem = album.items[3] player.setqueue(with: albumqueuedescriptor) let catalogsongstoreid: String =... let catalogqueuedescriptor = MPMusicPlayerStoreQueueDescriptor(storeIDs: [catalogsongstoreid]) player.prepend(catalogqueuedescriptor) let recentlyplayedsongplayparameters: [String: Any] =... let recentlyplayedsongqueuedescriptor = MPMusicPlayerPlayParametersQueueDescriptor( playparametersqueue: [recentlyplayedsongplayparameters] ) player.append(recentlyplayedsongqueuedescriptor)

118 let player = MPMusicPlayerController.systemMusicPlayer player.repeatmode =.all let album: MPMediaItemCollection =... let albumqueuedescriptor = MPMusicPlayerMediaItemQueueDescriptor(itemCollection: album) albumqueuedescriptor.startitem = album.items[3] player.setqueue(with: albumqueuedescriptor) let catalogsongstoreid: String =... let catalogqueuedescriptor = MPMusicPlayerStoreQueueDescriptor(storeIDs: [catalogsongstoreid]) player.prepend(catalogqueuedescriptor) let recentlyplayedsongplayparameters: [String: Any] =... let recentlyplayedsongqueuedescriptor = MPMusicPlayerPlayParametersQueueDescriptor( playparametersqueue: [recentlyplayedsongplayparameters] ) player.append(recentlyplayedsongqueuedescriptor)

119 let player = MPMusicPlayerController.systemMusicPlayer player.repeatmode =.all let album: MPMediaItemCollection =... let albumqueuedescriptor = MPMusicPlayerMediaItemQueueDescriptor(itemCollection: album) albumqueuedescriptor.startitem = album.items[3] player.setqueue(with: albumqueuedescriptor) let catalogsongstoreid: String =... let catalogqueuedescriptor = MPMusicPlayerStoreQueueDescriptor(storeIDs: [catalogsongstoreid]) player.prepend(catalogqueuedescriptor) let recentlyplayedsongplayparameters: [String: Any] =... let recentlyplayedsongqueuedescriptor = MPMusicPlayerPlayParametersQueueDescriptor( playparametersqueue: [recentlyplayedsongplayparameters] ) player.append(recentlyplayedsongqueuedescriptor)

120 let player = MPMusicPlayerController.systemMusicPlayer player.repeatmode =.all let album: MPMediaItemCollection =... let albumqueuedescriptor = MPMusicPlayerMediaItemQueueDescriptor(itemCollection: album) albumqueuedescriptor.startitem = album.items[3] player.setqueue(with: albumqueuedescriptor) let catalogsongstoreid: String =... let catalogqueuedescriptor = MPMusicPlayerStoreQueueDescriptor(storeIDs: [catalogsongstoreid]) player.prepend(catalogqueuedescriptor) let recentlyplayedsongplayparameters: [String: Any] =... let recentlyplayedsongqueuedescriptor = MPMusicPlayerPlayParametersQueueDescriptor( playparametersqueue: [recentlyplayedsongplayparameters] ) player.append(recentlyplayedsongqueuedescriptor)

121 let player = MPMusicPlayerController.systemMusicPlayer player.repeatmode =.all let album: MPMediaItemCollection =... let albumqueuedescriptor = MPMusicPlayerMediaItemQueueDescriptor(itemCollection: album) albumqueuedescriptor.startitem = album.items[3] player.setqueue(with: albumqueuedescriptor) let catalogsongstoreid: String =... let catalogqueuedescriptor = MPMusicPlayerStoreQueueDescriptor(storeIDs: [catalogsongstoreid]) player.prepend(catalogqueuedescriptor) let recentlyplayedsongplayparameters: [String: Any] =... let recentlyplayedsongqueuedescriptor = MPMusicPlayerPlayParametersQueueDescriptor( playparametersqueue: [recentlyplayedsongplayparameters] ) player.append(recentlyplayedsongqueuedescriptor)

122 // Advanced Queue Editing using applicationqueueplayer let player = MPMusicPlayerController.applicationQueuePlayer player.perform( queuetransaction: { (mutablequeue: MPMusicPlayerControllerMutableQueue) in // Remove 3rd item mutablequeue.remove(mutablequeue.items[2]) ) // Add song with storeid after 5th item let songstoreid: String =... let songqueuedescriptor = MPMusicPlayerStoreQueueDescriptor(storeIDs: [songstoreid]) mutablequeue.insert(songqueuedescriptor, after: mutablequeue.items[4]) }, completionhandler: { (queue: MPMusicPlayerControllerQueue, error: Error?) in }

123 // Advanced Queue Editing using applicationqueueplayer let player = MPMusicPlayerController.applicationQueuePlayer player.perform( queuetransaction: { (mutablequeue: MPMusicPlayerControllerMutableQueue) in // Remove 3rd item mutablequeue.remove(mutablequeue.items[2]) ) // Add song with storeid after 5th item let songstoreid: String =... let songqueuedescriptor = MPMusicPlayerStoreQueueDescriptor(storeIDs: [songstoreid]) mutablequeue.insert(songqueuedescriptor, after: mutablequeue.items[4]) }, completionhandler: { (queue: MPMusicPlayerControllerQueue, error: Error?) in }

124 // Advanced Queue Editing using applicationqueueplayer let player = MPMusicPlayerController.applicationQueuePlayer player.perform( queuetransaction: { (mutablequeue: MPMusicPlayerControllerMutableQueue) in // Remove 3rd item mutablequeue.remove(mutablequeue.items[2]) ) // Add song with storeid after 5th item let songstoreid: String =... let songqueuedescriptor = MPMusicPlayerStoreQueueDescriptor(storeIDs: [songstoreid]) mutablequeue.insert(songqueuedescriptor, after: mutablequeue.items[4]) }, completionhandler: { (queue: MPMusicPlayerControllerQueue, error: Error?) in }

125 // Advanced Queue Editing using applicationqueueplayer let player = MPMusicPlayerController.applicationQueuePlayer player.perform( queuetransaction: { (mutablequeue: MPMusicPlayerControllerMutableQueue) in // Remove 3rd item mutablequeue.remove(mutablequeue.items[2]) ) // Add song with storeid after 5th item let songstoreid: String =... let songqueuedescriptor = MPMusicPlayerStoreQueueDescriptor(storeIDs: [songstoreid]) mutablequeue.insert(songqueuedescriptor, after: mutablequeue.items[4]) }, completionhandler: { (queue: MPMusicPlayerControllerQueue, error: Error?) in }

126 // Advanced Queue Editing using applicationqueueplayer let player = MPMusicPlayerController.applicationQueuePlayer player.perform( queuetransaction: { (mutablequeue: MPMusicPlayerControllerMutableQueue) in // Remove 3rd item mutablequeue.remove(mutablequeue.items[2]) ) // Add song with storeid after 5th item let songstoreid: String =... let songqueuedescriptor = MPMusicPlayerStoreQueueDescriptor(storeIDs: [songstoreid]) mutablequeue.insert(songqueuedescriptor, after: mutablequeue.items[4]) }, completionhandler: { (queue: MPMusicPlayerControllerQueue, error: Error?) in }

127 // Advanced Queue Editing using applicationqueueplayer let player = MPMusicPlayerController.applicationQueuePlayer player.perform( queuetransaction: { (mutablequeue: MPMusicPlayerControllerMutableQueue) in // Remove 3rd item mutablequeue.remove(mutablequeue.items[2]) ) // Add song with storeid after 5th item let songstoreid: String =... let songqueuedescriptor = MPMusicPlayerStoreQueueDescriptor(storeIDs: [songstoreid]) mutablequeue.insert(songqueuedescriptor, after: mutablequeue.items[4]) }, completionhandler: { (queue: MPMusicPlayerControllerQueue, error: Error?) in }

128 Timeframe

129 Timeframe

130 Timeframe ios 10.3 Music user tokens (Fall) 1 Storefront country code 2 Catalog playback (with store IDs) *1 API in SKCloudServiceController exists under a different name. *2 As an approximation, you can use Locale.current.regionCode.

131 Timeframe ios 10.3 ios 11 Music user tokens (Fall) 1 Storefront country code 2 Catalog playback (with store IDs) Music user tokens Storefront country code Catalog playback (with store IDs) Catalog playback (with parameters) 3 *1 API in SKCloudServiceController exists under a different name. *2 As an approximation, you can use Locale.current.regionCode. *3 Available in an upcoming ios 11 Beta.

132 Summary Leverage Apple Music s content to keep your users engaged Get music user token from ios Use it to call Apple Music API Use Media Player to control playback

133 More Information

134 Related Sessions What's New in Audio Grand Ballroom B Tuesday 1:50PM What's New in Foundation Hall 2 Wednesday 11:00AM Introducing AirPlay 2 Executive Ballroom Thursday 4:10PM

135 Labs MusicKit Lab Technology Lab G Tue 4:10PM-6:00PM Audio Lab Technology Lab F Tue 4:10PM-6:00PM Foundation Lab Technology Lab C Wed 1:00PM-3:10PM MusicKit Lab Technology Lab F Wed 3:10PM-6:00PM Audio Lab Technology Lab G Thur 1:00PM-3:00PM

136