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
query
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.
- Utilisez uniquement les applications, comptes et ressources autorisés par l'utilisateur sur cette plateforme. Consultez la description spécifique à la plate-forme de cet outil pour connaître ses exigences de connexion et d'autorisation ; ce catalogue ne revendique pas d'étendues OAuth ou de droits d'exploitation supplémentaires pour le système d'exploitation.
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"
}