music_search_library
Muziek · macOS
Effect: lezen. Status: voorwaardelijk beschikbaar.
‘Voorwaardelijke beschikbaarheid’ betekent dat het hulpmiddel kan afhangen van versie, platform, machtigingen, account of configuratie. Het is niet in elke installatie actief.
macOS
Doel
Doorzoekt de nummers van de Muziek-bibliotheek van de gebruiker. `field` beperkt de zoekopdracht tot title, artist of album; de standaard, any, doorzoekt elk tekstveld dat ook de eigen zoekfunctie van de Muziek-app doorzoekt. Geeft van elk nummer id, titel, artiest, album en lengte terug; de id is wat music_playback en music_add_to_playlist nodig hebben. Alleen de bibliotheek wordt doorzocht, niet de Apple Music-catalogus. Opent de Muziek-app wanneer die gesloten is.
Vereiste invoer
query
De namen blijven exact zoals het hulpmiddel ze vereist. De canonieke technische definities in het Engels staan in het uitklapbare schema hieronder.
Machtigingen en bevestiging
Het schema bevat geen expliciete bevestigingsparameter. Dit geeft geen toestemming om te handelen; controleer het effect en vraag autorisatie.
- Gebruik uitsluitend de apps, accounts en bronnen waarvoor de gebruiker op dit platform toestemming heeft gegeven. Raadpleeg de platformspecifieke beschrijving van deze tool voor de verbindings- en toestemmingsvereisten; deze catalogus veronderstelt geen aanvullende OAuth-bereiken of OS-rechten.
Canoniek technisch schema in het Engels — 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"
}Documentatievoorbeeld
Documentatievoorbeeld voor music_search_library. Voer dit voorbeeld niet uit. De getoonde argumenten verwijzen naar fictieve gegevens; zoek vóór een echte aanroep de werkelijke identificatoren op en vraag toestemming.
{
"field": "title",
"limit": 10,
"query": "Moonlight Sonata"
}