Como baixar o MusicKit e por que você deve usá-lo
Se você é um desenvolvedor que deseja integrar o Apple Music ao seu aplicativo ou site, talvez queira conferir o MusicKit. O MusicKit é um conjunto de ferramentas e estruturas que permitem acessar e reproduzir músicas do Apple Music e da biblioteca de músicas local do usuário. Neste artigo, explicaremos o que é o MusicKit, o que ele pode fazer, como baixá-lo e instalá-lo e como usar seus recursos em seu aplicativo ou site. Também mostraremos alguns exemplos de aplicativos e sites que usam o MusicKit para fornecer uma experiência musical rica.
musickit download
O que é o MusicKit e o que ele pode fazer?
O MusicKit é um conjunto de tecnologias que permitem interagir com o Apple Music de várias maneiras. É composto por quatro componentes principais:
MusicKit para plataformas Apple
MusicKit para Android
MusicKit para Web
API de música da Apple
Vamos dar uma olhada em cada um deles com mais detalhes.
MusicKit para plataformas Apple
O MusicKit para plataformas Apple é uma estrutura baseada em Swift que permite criar aplicativos para iOS, iPadOS, macOS, Mac Catalyst, tvOS e watchOS que integram o Apple Music. Você pode usá-lo para encontrar conteúdo no catálogo do Apple Music ou na biblioteca de músicas do usuário, controlar a reprodução, verificar o status da assinatura do usuário, adicionar músicas à biblioteca do usuário e muito mais. Você também pode usá-lo para apresentar ofertas de assinatura de música para usuários que podem não ter uma assinatura ativa do Apple Music. Para saber mais sobre o MusicKit para plataformas Apple, visite .
MusicKit para Android
O MusicKit para Android é um conjunto de bibliotecas que permite criar recursos nativos do Apple Music em seu aplicativo Android. Você pode usá-lo para permitir que os usuários façam login em suas contas do Apple Music e reproduzam músicas diretamente do seu aplicativo. Você também pode acessar a API do Apple Music para recuperar informações sobre álbuns, músicas, artistas, listas de reprodução, videoclipes e muito mais. Para baixar o MusicKit SDK para Android, visite .
MusicKit para Web
MusicKit for Web é uma tecnologia baseada em JavaScript que permite transmitir músicas, videoclipes e rádio do Apple Music em seu site. Você pode usá-lo para criar um player personalizado usando JavaScript ou usar os componentes da Web predefinidos que fornecem um player pronto. Você também pode acessar a API do Apple Music para recuperar informações sobre itens de música e executar ações em nome do usuário. Para saber mais sobre o MusicKit for Web, visite .
API de música da Apple
A API do Apple Music é um serviço da Web que permite acessar informações sobre itens de música no catálogo do Apple Music e na biblioteca de músicas do usuário. Você pode usá-lo para recuperar informações sobre álbuns, músicas, artistas, listas de reprodução, videoclipes, estações, classificações, gráficos, recomendações e muito mais. Você também pode usá-lo para criar ou modificar listas de reprodução e aplicar classificações ao conteúdo do usuário. A API pode ser usada com aplicativos para plataformas Apple, aplicativos Android e sites. Para começar a usar a API do Apple Music, visite How to Download and Install MusicKit
Depending on the platform you are developing for, the process of downloading and installing MusicKit may vary. Here are the steps for each platform:
Downloading MusicKit SDK for Android
To download the MusicKit SDK for Android, you need to have an Apple Developer account and a valid Apple Music subscription. You also need to have Android Studio and the Android SDK installed on your computer. Here are the steps to download the MusicKit SDK for Android:
Go to e faça login com sua conta de desenvolvedor da Apple.
Clique no botão "Baixar MusicKit SDK para Android" e concorde com os termos e condições.
Salve o arquivo ZIP em seu computador e descompacte-o.
Abra o Android Studio e crie um novo projeto ou abra um existente.
Copie a pasta MusicKit do SDK descompactado para a pasta libs do seu aplicativo.
Adicione as seguintes dependências ao arquivo build.gradle do seu aplicativo:
dependências implementação fileTree(dir: 'libs', include: ['*.jar']) implementação 'com.android.support:appcompat-v7:28.0.0' implementação 'com.android.support:design:28.0.0' implementação 'com.android.support:support-v4:28.0.0' implementação 'com.google.code.gson:gson:2.8.5' implementação 'com.squareup.okhttp3:ok http:3.12.1' implementação 'com.squareup.okio:okio:1.15.0'
Sincronize seu projeto e construa-o.
Incorporando o MusicKit JS em sua página da Web
Para incorporar o MusicKit JS em sua página da web, você precisa ter uma conta de desenvolvedor da Apple e uma assinatura válida do Apple Music. Você também precisa ter um site que suporte HTTPS e tenha um certificado SSL válido. Aqui estão os passos para incorporar MusicKit JS em sua página web:
Vá para e faça login com sua conta de desenvolvedor da Apple.
Clique no botão "Começar" e siga as instruções para criar um identificador do MusicKit e uma chave privada.
Baixe o arquivo de chave privada e salve-o em um local seguro.
Copie o identificador do MusicKit e guarde-o para uso posterior.
Adicione a seguinte tag de script à seção de cabeçalho de sua página da Web:
<script src="
Adicione a seguinte tag de script à seção do corpo de sua página da Web, substituindo YOUR_MUSICKIT_IDENTIFIER pelo seu identificador real do MusicKit:
window.MusicKit.configure( developerToken: 'YOUR_MUSICKIT_IDENTIFIER', app: name: 'Your App Name', build: 'Your App Version' );
Configurando o MusicKit JS
Antes de poder usar os recursos do MusicKit JS em sua página da Web, você precisa configurar algumas opções e eventos. Aqui estão algumas das opções e eventos comuns que você pode usar:
Opção/EventoDescrição
desenvolvedorTokenUma string que identifica seu aplicativo e concede acesso à API do Apple Music.
nome do aplicativoUma string que especifica o nome do seu aplicativo.
app.buildUma string que especifica a versão do seu aplicativo.
musicUserTokenUma string que identifica o usuário que está conectado ao Apple Music em sua página da web.
isUserAuthorized()Um método que retorna um valor booleano indicando se o usuário está autorizado a acessar o conteúdo do Apple Music.
autorizar()Um método que solicita que o usuário faça login no Apple Music em sua página da web.
desautorizar()Um método que desconecta o usuário do Apple Music em sua página da web.
addEventListener()Um método que registra uma função de retorno de chamada para um evento específico, como authorizationStatusDidChange, playbackStateDidChange, mediaItemDidChange etc.
removeEventListener()Um método que cancela o registro de uma função de retorno de chamada para um evento específico.
músicaUma propriedade que retorna um objeto MusicKitInstance que fornece acesso a itens de música, controles de reprodução e outros recursos.
Para obter mais informações sobre as opções e eventos do MusicKit JS, visite .
Usando o MusicKit Framework para plataformas Apple
Para usar o MusicKit Framework para plataformas Apple, você precisa ter o Xcode e a versão mais recente do MusicKit framework instalado em seu computador. Você também precisa ter uma conta de desenvolvedor da Apple e uma assinatura válida do Apple Music. Aqui estão as etapas para usar o MusicKit Framework para plataformas Apple:
Vá para e faça login com sua conta de desenvolvedor da Apple.
Baixe e instale a versão mais recente do Xcode e da estrutura MusicKit.
Abra o Xcode e crie um novo projeto ou abra um existente.
Selecione seu projeto no Project Navigator e vá para a guia Signing & Capabilities.
Adicione o recurso MusicKit ao seu aplicativo clicando no botão + e selecionando MusicKit na lista.
Importe a estrutura MusicKit em seus arquivos Swift adicionando a seguinte linha no topo:
importar MusicKit
Use as classes e métodos do MusicKit para acessar e reproduzir músicas do Apple Music e da biblioteca de músicas do usuário. Por exemplo, você pode usar o código a seguir para criar um music player e reproduzir uma música:
let player = MPMusicPlayerController.applicationMusicPlayer let song = MPMediaItemCollection(itens: [MPMediaItem(título: "Olá", artista: "Adele")]) player.setQueue(with: song) player.play()
Como usar os recursos do MusicKit em seu aplicativo ou site
Agora que você baixou e instalou o MusicKit, pode começar a usar seus recursos em seu aplicativo ou site. Aqui estão alguns dos recursos comuns que você pode usar:
Autorização do usuário
A autorização do usuário é o processo que permite que os usuários façam login em suas contas do Apple Music e concedam ao seu aplicativo ou site permissão para acessar o conteúdo musical deles. Você pode usar o MusicKit para realizar a autorização do usuário de diferentes maneiras, dependendo da plataforma. Por exemplo, você pode usar os seguintes métodos:
Para aplicativos Android, você pode usar o método authorize() da classe MusicUser para solicitar que o usuário faça login e autorize seu aplicativo.
Para sites, você pode usar o método authorize() da classe MusicKitInstance para solicitar que o usuário entre e autorize seu site.
Para aplicativos para plataformas Apple, você pode usar o método requestUserToken(forDeveloperToken:) da classe SKCloudServiceController para solicitar um token de usuário para seu aplicativo.
Para obter mais informações sobre a autorização do usuário, visite .
Itens e atributos musicais
Itens de música são objetos que representam o conteúdo musical do Apple Music ou da biblioteca de músicas do usuário. Eles podem ser músicas, álbuns, artistas, listas de reprodução, videoclipes, estações, gêneros, etc. Cada item de música possui um conjunto de atributos que descrevem suas propriedades, como título, artista, capa, duração, gênero etc. Por exemplo, você pode usar as seguintes classes:
Para aplicativos Android, você pode usar a classe MediaItem e suas subclasses para representar itens de música e seus atributos.
Para sites, você pode usar a classe MusicKit.MediaItem e suas subclasses para representar itens de música e seus atributos.
Para aplicativos para plataformas Apple, você pode usar a classe MPMediaItem e suas subclasses para representar itens de música e seus atributos.
Para obter mais informações sobre itens e atributos musicais, visite .
Pesquisa e Solicitação de Catálogo
A pesquisa e solicitação de catálogo é o processo de localizar e recuperar itens de música do catálogo do Apple Music ou da biblioteca de músicas do usuário. Você pode usar o MusicKit para realizar pesquisas e solicitações de catálogos de diferentes maneiras, dependendo da plataforma. Por exemplo, você pode usar os seguintes métodos:
Para aplicativos Android, você pode usar a classe MusicCatalog e seus métodos para pesquisar e solicitar itens musicais do catálogo do Apple Music.
Para sites, você pode usar a propriedade music.catalog e seus métodos da classe MusicKitInstance para pesquisar e solicitar itens de música do catálogo do Apple Music.
Para aplicativos para plataformas Apple, você pode usar a classe MPMediaQuery e seus métodos para pesquisar e solicitar itens de música da biblioteca de música do usuário.
Para obter mais informações sobre pesquisa e solicitação de catálogo, visite .
Reprodução e controle de mídia
Reprodução e controle de mídia é o processo de reproduzir e controlar itens de música do Apple Music ou da biblioteca de músicas do usuário. Você pode usar o MusicKit para reproduzir e controlar a mídia de diferentes maneiras, dependendo da plataforma. Por exemplo, você pode usar as seguintes classes:
Para aplicativos Android, você pode usar a classe MusicPlayer e seus métodos para reproduzir e controlar itens de música do seu aplicativo.
Para sites, você pode usar a propriedade music.player e seus métodos da classe MusicKitInstance para reproduzir e controlar itens de música de seu site.
Para aplicativos para plataformas Apple, você pode usar a classe MPMusicPlayerController e seus métodos para reproduzir e controlar itens de música de seu aplicativo.
Para obter mais informações sobre reprodução e controle de mídia, visite .
Ofertas e testes de assinatura de música
As ofertas e testes de assinatura de música são formas de apresentar as opções de assinatura do Apple Music para usuários que podem não ter uma assinatura ativa.Você pode usar o MusicKit para apresentar ofertas e testes de assinatura de música de diferentes maneiras, dependendo da plataforma. Por exemplo, você pode usar os seguintes métodos:
Para aplicativos Android, você pode usar o método showSubscriptionOffer() da classe MusicUser para apresentar uma oferta de assinatura ao usuário.
Para sites, você pode usar o método showSubscribeView() da classe MusicKitInstance para apresentar uma oferta de assinatura ao usuário.
Para aplicativos para plataformas Apple, você pode usar a classe SKCloudServiceSetupViewController e seus métodos para apresentar uma oferta de assinatura ou avaliação ao usuário.
Para obter mais informações sobre ofertas e testes de assinatura de música, visite .
Alguns exemplos de aplicativos e sites que usam o MusicKit
Para lhe dar alguma inspiração, aqui estão alguns exemplos de aplicativos e sites que usam o MusicKit para fornecer uma experiência musical rica:
NomeDescriçãoPlataforma
shazamUm aplicativo popular que identifica músicas ao ouvi-las. Ele usa o MusicKit para permitir que os usuários reproduzam músicas do Apple Music, adicionem-nas à biblioteca ou criem listas de reprodução.iOS, Android
SongShiftUm aplicativo que permite aos usuários transferir suas listas de reprodução entre diferentes serviços de música. Ele usa o MusicKit para acessar e modificar listas de reprodução do Apple Music.iOS
MushUm site que permite aos usuários acessar sua biblioteca do Apple Music de qualquer navegador. Ele usa MusicKit JS para transmitir músicas, listas de reprodução, álbuns, artistas, etc. da Apple Music.Rede
Last FMUm site que rastreia os hábitos de escuta dos usuários e fornece recomendações personalizadas. Ele usa o MusicKit JS para permitir que os usuários reproduzam músicas do Apple Music em seu site.Rede
mínimoUm aplicativo que permite aos usuários criar listas de reprodução inteligentes com base em vários critérios. Ele usa o MusicKit para acessar e reproduzir músicas do Apple Music ou da biblioteca de músicas do usuário.iOS
Conclusão
Neste artigo, aprendemos o que é o MusicKit, o que ele pode fazer, como baixá-lo e instalá-lo e como usar seus recursos em seu aplicativo ou site. Também vimos alguns exemplos de aplicativos e sites que usam o MusicKit para fornecer uma experiência musical rica. Se você é um desenvolvedor que deseja integrar o Apple Music em seu aplicativo ou site, você definitivamente deveria experimentar o MusicKit. É uma tecnologia poderosa e fácil de usar que aprimorará seu aplicativo de música ou site com o mínimo de esforço.
perguntas frequentes
Aqui estão algumas perguntas frequentes sobre o MusicKit e suas respostas:
P: Preciso de uma assinatura do Apple Music para usar o MusicKit?
R: Sim, você precisa de uma assinatura ativa do Apple Music para usar os recursos do MusicKit em seu aplicativo ou site. Você também precisa ter uma conta de desenvolvedor da Apple e um token de desenvolvedor válido.
P: Como obtenho um token de desenvolvedor para o MusicKit?
R: Você pode obter um token de desenvolvedor para MusicKit criando um identificador MusicKit e uma chave privada no portal Apple Developer. Você pode usar a chave privada para gerar um token de desenvolvedor usando o formato JWT (JSON Web Token). Para mais detalhes, visite .
P: Como lidar com erros e exceções no MusicKit?
R: Você pode lidar com erros e exceções no MusicKit usando os métodos e propriedades apropriados das classes do MusicKit. Por exemplo, você pode usar a propriedade error da classe MusicPlayer para obter o objeto de erro que ocorreu durante a reprodução. Você também pode usar o método addEventListener() da classe MusicKitInstance para registrar uma função de retorno de chamada para o evento de erro. Para mais detalhes, visite .
P: Como faço para testar meu aplicativo ou site que usa o MusicKit?
R: Você pode testar seu aplicativo ou site que usa MusicKit usando o ambiente Apple Music Sandbox.O Apple Music Sandbox é um ambiente separado que permite testar seu aplicativo ou site sem afetar sua conta ou biblioteca real do Apple Music. Você pode usar o mesmo token de desenvolvedor e token de usuário que usa para o ambiente de produção, mas precisa usar um URL base diferente para as solicitações de API do Apple Music. Para mais detalhes, visite .
P: Onde posso encontrar mais recursos e documentação sobre o MusicKit?
R: Você pode encontrar mais recursos e documentação sobre o MusicKit visitando os seguintes links:
: O site oficial do MusicKit.
: A documentação oficial do MusicKit.
: Uma apresentação em vídeo sobre o MusicKit da WWDC 2017.
: Uma apresentação em vídeo sobre o MusicKit da WWDC 2018.
: Uma apresentação em vídeo sobre o MusicKit da WWDC 2019.
: Uma apresentação em vídeo sobre o MusicKit da WWDC 2020.
: um fórum para desenvolvedores discutirem e fazerem perguntas sobre o MusicKit.
0517a86e26
コメント