music_search_library

macOS

Finalidade

Pesquisa as faixas da biblioteca do Music do usuário. `field` restringe a pesquisa a title, artist ou album; o padrão, any, pesquisa todos os campos de texto que a pesquisa do próprio app Music pesquisa. Retorna o id, o título, o artista, o álbum e a duração de cada faixa; o id é o que music_playback e music_add_to_playlist recebem. Somente a biblioteca é pesquisada, não o catálogo do Apple Music. Abre o app Music quando ele está fechado.

Entradas obrigatórias

• query

Os nomes são mantidos exatamente como a ferramenta exige. As definições técnicas canónicas em inglês estão no esquema expansível abaixo.

Permissões e confirmação

O esquema não declara um parâmetro explícito de confirmação. Isto não autoriza qualquer ação sem permissão; reveja o efeito e obtenha autorização.

• Utilize apenas os aplicativos, contas e recursos autorizados pelo usuário nesta plataforma. Consulte a descrição específica da plataforma desta ferramenta para saber os requisitos de conexão e permissão; este catálogo não reivindica escopos OAuth adicionais ou direitos de sistema operacional.

{
  "properties": {
    "field": {
      "description": "Where to look (default any).",
      "enum": [
        "any",
        "title",
        "artist",
        "album"
      ],
      "type": "string"
    },
    "limit": {
      "description": "Tracks to return (default 25, max 100).",
      "maximum": 100,
      "minimum": 1,
      "type": "integer"
    },
    "query": {
      "description": "Text to look for.",
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "type": "object"
}

Exemplo documental

Exemplo de documentação para music_search_library. Não execute este exemplo. Os argumentos apresentados pertencem a um conjunto de dados fictício; resolva identificadores reais e obtenha autorização antes de uma chamada real.

{
  "field": "title",
  "limit": 10,
  "query": "Moonlight Sonata"
}