🎵MusicKit

MusicKit 개요

1. 클라이언트 프레임워크
2. AppleMusic API

로 구성 되어있음

MusicKit 기능

1. AppleMusic 콘텐츠를 요청할 수 있고
2. 대규모 음악 리스트를 불러올 시에, 갯수 제한 혹은 페이지네이션으로 관리
3. 검색 및, 인기 차트 등을 탐색할 수 있음

클라이언트 프레임워크를 통해

구독자인지를 인증할 수 있고 재생을 제어하는 API 제공

Apple기기들 (Swift) / Web(JavaScript) / Android(특정 SDK로 한정) 에서 MusicKit을 사용 가능

우리의 경우엔 Apple기기들의 경우만 살펴도 무방할 것 같음.

애플 기기들에서의 MusicKit 사용에 관한 내용은 “Meet MusicKit for Swift” 참고

Apple기기에서 MusicKit을 사용하기 위해서는  Certificates, Identifiers & Profiles에서 토큰을 활성화 하여 사용 가능

해당 부분에 체크하여 Token 관리 가능

현재는 개발자 계정 및 팀이 없어서 사용 불가한듯

원래는 인증 헤더에 유효 & 서명된 토큰을 제공해야 Apple Music API를 사용할 수 있지만 Apple 기기 위에서 사용된다면 이 기능은 생략 가능함. (고로 우리가 Web이나 안드로이드를 사용하지 않는다면 인증 토큰에 대한 부분은 무시가능)

Apple Music API를 이용한 리소스 요청

애플뮤직의 컨텐츠들은 Resource로 모델링 되어있음 (아티스트, 제목, 앨범이름 등등…)

각각에 해당되는 Type들이 존재한다고 함. Resource들은 식별자(Identifier)를 통해 fetch해오거나, 검색 가능함

https://api.music.apple.com/v1/catalog/us/playlists/pl.2b0e6e332fdf4

위와 같이 RESTful API 요청을 통해 가져올 수 있음.

v1 : API 버전을 나타며 이후 변경될 수 있으며, 변경되더라도 기존의 호출과의 역호환성을 유지한다고 함.

catalog/us : 카탈로그 내의 요청? ← 뭔말인지 모르겠음 . us는 국가 코드로서 우리나라는 kr. 국가마다 서비스 되는 곡의 종류가 다르기도 하고 요금정책도 다르기 때문에 괜히 이상한 거 안 건드리는게 좋을 것 같음. (결과적으로 음악을 재생하고 사용해야 한다면 구독자 인증이 필요하고, 우리의 대상은 한국 계정을 쓸 것이므로)

playlists: 플레이리스트라는 뜻 그 이후는 식별자 변화

이후 ?l=en-US 를 추가하여 언어 태그를 지정할 수도 있음. 언어 뿐만 아니라 현지화도 적용이 되는 것 같음. 예를들어 스페인어는 사용국가가 많은데, 이중 멕시코에서 스페인어를 사용하는 사람들이라면, ?l=es-MX 를 적용해야함

한국어는 ko

밑에는 api 요청 주소는 아니고, 제 개인 플레이리스트의 실제 url 주소인데, 뒷 부분을 보면

고유식별자, 언어설정 등을 확인할 수 있음

https://music.apple.com/kr/library/playlist/p.AWXoollUL2oZ1oA?l=ko

https://api.music.apple.com/v1/catalog/ko/playlist/p.1YeW315FqgQlaQE

GET 요청 예시

id는 해당 컨텐츠의 고유식별자 (지금의 경우엔 특정 플레이리스트의 고유 식별자값)

href는 리소스를 가져올 수 있는 API의 위치

콘텐츠에 대한 메타 데이터(재생목록의 이름, 큐레이터의 이름, 재생목록의 설명)는 attributes 에서 찾을 수 있음.

해당 플레이리스트의 큐레이터(작성자) 및 수록된 트랙들의 정보는 relationships 에 포함

예시가 플레이리스트로 나와 있어서, 우리의 경우에는 실제 API 요청을 보내보고 attributes, relationships등 내부 속성들의 값을 봐서 판단해야할 것 같음.

플레이리스트의 예시에서 attributes 내부를 더 들여다 보면, 플레이리스트의 메타 데이터를 포함하고 있음.

name, curatorName, description은 각각 플레이 리스트 이름, 작성자, 설명등에 대치 되고 (사진 참조)

playParams는 재생을 제어하는 역할을 한다고 함. (없으면 재생 불가능한 컨텐츠)

artwork ( 플레이리스트 커버 사진, 앨범 커버 등등)은 리소스의 아트워크 속성을 찾아 가져올 수 있다고 함.

요청 url의 파란색 부분의 숫자를 변경하여 아트워크 이미지의 크기를 결정할 수 있다고 함. 대부분 정방형이므로 그냥 같은 값 입력하면 될 것 같음. (근데 일부 앨범 커버들은 정방형이 아닌 것들이 있기도 함)

요청을 통해 플레이리스트의 목록을 가져올 때 100개 이하면 그냥 단일 요청으로 가져와지지만, 그 이상의 요청이 될 경우에는 앞의 100개만 먼저 가져와지고 뒤에는 페이지의 개념으로 넘어가게 된다고 함.

100개를 초과하는 경우에는 relationships 부분에 next라는 속성이 생기고, 그다음 요청을 보내야할 링크를 제공받을 수 있음. 해당 링크는 offset=100이므로 해당 재생목록에서 100번 이후의 목록들을 가져올 수 있는 링크가 제공됨. 이를 통해 요청해서 이후의 것들을 가져올 수 있음. 더이상 없으면 next 안뜸.

100개는 조절 가능해보임

아까 봤던 api요청 주소의 catalog/국가/search를 하면 검색어를 사용할 수 있음.

/v1/catalog/us/search?term=pop&types=albums,songs&limit=10

term=[검색어]

types=[관심있는 타입 → 가수인지, 앨범인지, 노래제목인지] 복수선택 가능

limit=표시되는 최대 크기