Aller au contenu
Tous les outils

music_search_library

Musique · macOS

Effet: lecture. État: disponibilité conditionnelle.

«Disponibilité conditionnelle» signifie que l’outil peut dépendre de la version, de la plateforme, des autorisations, du compte ou de la configuration. Il n’est pas forcément actif partout.

macOS

Objectif

Recherche les morceaux de la bibliothèque Musique de l’utilisateur. `field` restreint la recherche à title, artist ou album ; par défaut, any parcourt tous les champs texte que parcourt la recherche propre à l’app Musique. Renvoie l’id, le titre, l’artiste, l’album et la durée de chaque morceau ; l’id est ce que prennent music_playback et music_add_to_playlist. Seule la bibliothèque est parcourue, pas le catalogue Apple Music. Ouvre l’app Musique lorsqu’elle est fermée.

Entrées requises

Les noms restent exactement ceux exigés par l’outil. Les définitions techniques canoniques en anglais figurent dans le schéma dépliable ci-dessous.

Autorisations et confirmation

Le schéma ne déclare aucun paramètre de confirmation explicite. Cela n’autorise aucune action sans permission : vérifiez l’effet et obtenez une autorisation.

Schéma technique canonique en anglais — macOS
{
  "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"
}

Exemple documentaire

Exemple de documentation pour music_search_library. N’exécutez pas cet exemple. Les arguments présentés appartiennent à un jeu de données fictif ; résolvez les identifiants réels et obtenez une autorisation avant tout appel réel.

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