利用 iOS 11 的 MusicKit 存取 Apple Music 的音樂。

1. 創作 MusicKit
告⽩白情歌
彼得潘

2. http://apppeterpan.strikingly.com
彼得潘簡介

3. 叫我彼得潘，Peter，Deeplove，
⻤鬼塚，Swift⼩小王⼦子，情歌王⼦子
莫叫我⽼老老師
http://bit.ly/2xe9eOG

4. MusicKit
付費會員才能開發
實機才能測試
https://developer.apple.com/musickit/

5. 學習重點
• Apple Music API
• StoreKit & MediaPlayer framework
• Apple 官⽅方的 sample code
http://bit.ly/2BfKSVN

6. Demo App
https://github.com/AppPeterPan/MusicKitDemo

7. Apple Music API
• Developer Token
• 所有的 API 都需要，⽐比⽅方 search 周杰倫倫的歌
• User Token
• 和使⽤用者有關的 API，⽐比⽅方使⽤用者最近播放的專輯
• 利利⽤用 developer token ⽣生成

8. ⽣生成 MusicKit App 需要的
developer token
http://bit.ly/2DlRLXH

9. 測試 Apple Music API

10. http://bit.ly/2mUD3j9
測試 Apple Music API

11. Apple Music API
• API 網⾴頁
• https://apple.co/2vW3MCt
• 以 https://api.music.apple.com/v1/ 開頭
• 存取某個國家的⾳音樂樂樂樂資料料
• https://api.music.apple.com/v1/catalog/{storefront}/albums/{id}
• catalog/{storefront}
• storefront: 國家代碼，ISO-Alpha2 country code
• ex: tw
• http://www.nationsonline.org/oneworld/country_code_list.htm
• 存取個⼈人的⾳音樂樂樂樂資料料
• https://api.music.apple.com/v1/me/ratings/albums/{id}
• me/

12. 從 iTunes 知道
歌⼿手，專輯，歌曲的 id
https://itunes.apple.com/tw/artist/jay-chou/300117743?l=en
https://api.music.apple.com/v1/catalog/tw/artists/300117743

13. 從 iTunes 知道
歌⼿手，專輯，歌曲的 id
https://itunes.apple.com/tw/album/%E5%91%8A%E7%99%BD%E6%B0%A3%E7%90%83/1118757859?i=1118757877&l=en
https://api.music.apple.com/v1/catalog/tw/songs/1118757877

14. 參參數數: include
https://api.music.apple.com/v1/catalog/tw/artists/300117743?include=playlists,music-videos
指定額外包含的 relationship

15. search
https://api.music.apple.com/v1/catalog/tw/search?types=songs&term=戴佩妮

16. search
curl -H 'Authorization: Bearer
eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6IlFDTjVIWjUzTk4ifQ.
eyJpc3MiOiJHNEhMOThMWDZMIiwiaWF0IjoxNTE2NDUwOTE1LCJleH
AiOjE1MTY0OTQxMTV9.zSdf73HMQcoAgSQqhHEA2xD7b2yz7z-
NsXK4PKsaGdbETsMAylAaMnq2-
GWdDSmKSdSSGZ8HZtnASvAr95ghUA' 'https://api.music.apple.com/
v1/catalog/tw/search?term=戴佩妮' | pbcopy
http://jsoneditoronline.org

17. search

18. search
指定 type
curl -H 'Authorization: Bearer
eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6IlFDTjVIWjUzTk4ifQ.
eyJpc3MiOiJHNEhMOThMWDZMIiwiaWF0IjoxNTE2NDUwOTE1LCJleH
AiOjE1MTY0OTQxMTV9.zSdf73HMQcoAgSQqhHEA2xD7b2yz7z-
NsXK4PKsaGdbETsMAylAaMnq2-
GWdDSmKSdSSGZ8HZtnASvAr95ghUA' 'https://api.music.apple.com/
v1/catalog/tw/search?types=songs&term=戴佩妮' | pbcopy
http://jsoneditoronline.org

19. search

20. 分⾴頁
next, limit, offset
limit 的上限 25
curl -H 'Authorization: Bearer
eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6IlFDTjVIWjUzTk4ifQ.
eyJpc3MiOiJHNEhMOThMWDZMIiwiaWF0IjoxNTE2NDUwOTE1LCJleH
AiOjE1MTY0OTQxMTV9.zSdf73HMQcoAgSQqhHEA2xD7b2yz7z-
NsXK4PKsaGdbETsMAylAaMnq2-
GWdDSmKSdSSGZ8HZtnASvAr95ghUA' 'https://api.music.apple.com/
v1/catalog/tw/search?types=songs&term=戴佩妮&limit=25' | pbcopy

21. 分⾴頁
curl -H 'Authorization: Bearer
eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6IlFDTjVIWjUzTk4ifQ.
eyJpc3MiOiJHNEhMOThMWDZMIiwiaWF0IjoxNTE2NDUwOTE1LCJleH
AiOjE1MTY0OTQxMTV9.zSdf73HMQcoAgSQqhHEA2xD7b2yz7z-
NsXK4PKsaGdbETsMAylAaMnq2-
GWdDSmKSdSSGZ8HZtnASvAr95ghUA' 'https://api.music.apple.com/
v1/catalog/tw/search?types=songs&term=戴佩妮&limit=25&offset=25' |
pbcopy
⽅方法1: 從 next 得到下⼀一⾴頁的網址
⽅方法2: ⾃自⼰己累加 offset
沒有下⼀一⾴頁: 沒有 next 欄欄位

22. iOS App 範例例程式

23. 模仿 Apple Sample Code

24. App 要求存取 music
的權限

25. 閃退
2018-01-20 23:34:54.867234+0800 MusicKitDemo[8440:3181243] [access] This app
has crashed because it attempted to access privacy-sensitive data without a usage
description. The app's Info.plist must contain an NSAppleMusicUsageDescription key
with a string value explaining to the user how the app uses this data.
SKCloudServiceController.requestAuthorization(_:)
抓取 Apple Music 的⾳音樂樂樂樂不不需要使⽤用者同意
但是播放⾳音樂樂樂樂需要

26. 要求存取 Apple Music的權限
Privacy - Media Library Usage Description

27. 要求存取 Apple Music的權限

28. 權限取得步驟
• 取得 developer token
• StoreKit & SKCloudServiceController
• 徵求使⽤用者同意
SKCloudServiceController.requestAuthorization(_:)
• 如果 authorized，取得 Cloud Service Capabilities

29. 權限取得步驟
• 如果能⼒力力包含 playback，表示使⽤用者有付⽉月租，可
以聽歌
• 取得 user token & store 的國家代碼
• 如果不不能 playback, 但可以訂閱，
(musicCatalogSubscriptionEligible)，顯示要使⽤用者
訂閱的畫⾯面
• SKCloudServiceSetupViewController

30. SKCloudServiceSetupViewController

31. 打開 iCloud ⾳音樂樂樂樂資料料庫的開關
才能將⾳音樂樂樂樂加到播放列列表

32. 其它程式解說

33. Search 和分⾴頁
• SearchTableViewController &
RecentTableViewController 繼承
MediaItemTableViewController
• performAppleMusicCatalogSearch
• 利利⽤用 nextPath 參參數數組合下⼀一⾴頁的 URL
https://apple.co/2DrAfFs

34. 解析 JSON
• processMediaItems
• JSONKeys.swift
• MediaItem.swift

35. 沒有更更多資料料了了
• 沒有 next 欄欄位
• search 告⽩白氣球 demo
func processMediaItems(from json: Data) throws -> ([MediaItem], String?) {
guard let jsonDictionary = try JSONSerialization.jsonObject(with:
json, options: []) as? [String: Any],
let results = jsonDictionary[ResponseRootJSONKeys.results] as?
[String: [String: Any]] else {
throw
SerializationError.missing(ResponseRootJSONKeys.results)
}
var songMediaItems = [MediaItem]()
var next: String?
if let songsDictionary = results[ResourceTypeJSONKeys.songs] {
next = songsDictionary[ResponseRootJSONKeys.next] as? String

36. search hint
https://apple.co/2mUHYRf

37. search hint
curl -H 'Authorization: Bearer
eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6IjVaOVgz
SFgyUkMifQ.eyJpc3MiOiJHNEhMOThMWDZMIiwiaWF0Ijox
NTE1OTI1MTYzLCJleHAiOjE1MzE2NDk5NjN9.7SCwUodMxi
p2NYOdkNy40vvj9YTRzHeyUcmLIovXV1jfDQbu9guzFLDqk
0dzNaXti_VrXYH8UbzxQbv8LqZr2Q' "https://
api.music.apple.com/v1/catalog/tw/search/hints?term=戴" |
pbcopy

38. 最近播放的專輯
https://apple.co/2DwHOKQ
需要 user token

39. MediaPlayer

40. 播放⾳音樂樂樂樂
• MediaPlayer framework
• MPMusicPlayerController
• function play

41. 正在播放的⾳音樂樂樂樂
• nowPlayingItem
• playbackStoreID
• 從 ID 找 song 的資訊
https://apple.co/2FYx3yC

42. 使⽤用者的 playlist
func getPlaylists() -> [MPMediaPlaylist] {
let playlistsQuery = MPMediaQuery.playlists()
if let playlists = playlistsQuery.collections as? [MPMediaPlaylist] {
return playlists
} else {
return [MPMediaPlaylist]()
}
}

43. add to playlist
func addItem(withProductID productID: String, completionHandler: ((Error?) ->
Swift.Void)? = nil)

44. Rating

45. like / dislike
https://apple.co/2Dn5QEf

46. one more thing

47. JSONDecoder 解析 JSON
http://bit.ly/2DpQnmR

48. JSONDecoder 解析 JSON
import PlaygroundSupport
import Foundation
PlaygroundPage.current.needsIndefiniteExecution = true
struct SearchResults: Codable {
struct Attribute: Codable {
var name: String
var artistName: String
var albumName: String
}
struct SongData: Codable {
var id: String
var attributes: Attribute
}
struct Songs: Codable {
var href: URL
var next: URL?
var data: [SongData]
}
struct Results: Codable {
var songs: Songs
}
var results: Results
}

49. JSONDecoder 解析 JSON
let appleMusicAPIBaseURLString = "api.music.apple.com"
let countryCode = "tw"
let developerToken =
"eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6IlFDTjVIWjUzTk4ifQ.eyJpc3MiOiJHNEhMOThMWDZMIiwiaWF0IjoxNTE2NTAyMzU1LCJle
HAiOjE1MTY1NDU1NTV9.2d1W7lqX2g2AG3Pzbe-UJ6-yoCXhaAxsqssEE98hIipdB7BORIJUpzE9mKMmrwv5ibAq0HCnStfOzckhFMUXBw"
var urlComponents = URLComponents()
urlComponents.scheme = "https"
urlComponents.host = appleMusicAPIBaseURLString
urlComponents.path = "/v1/catalog/(countryCode)/search"
let urlParameters = ["term": "周杰倫倫", "types": "songs"]
var queryItems = [URLQueryItem]()
for (key, value) in urlParameters {
queryItems.append(URLQueryItem(name: key, value: value))
}
urlComponents.queryItems = queryItems
var urlRequest = URLRequest(url: urlComponents.url!)
urlRequest.httpMethod = "GET"
urlRequest.addValue("Bearer (developerToken)", forHTTPHeaderField: "Authorization")
let task = URLSession.shared.dataTask(with: urlRequest) { (data, response, error) in
guard error == nil, let urlResponse = response as? HTTPURLResponse, urlResponse.statusCode == 200, let data =
data else {
print("task error")
return
}
let decoder = JSONDecoder()
if let songResults = try? decoder.decode(SearchResults.self, from: data) {
for song in songResults.results.songs.data {
print(song.attributes.name)
}
} else {
print("JSON error")
}
}
task.resume()