Naar de inhoud
Alle hulpmiddelen

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

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.

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"
}