Naar de inhoud
Alle hulpmiddelen

music_add_to_playlist

Muziek · macOS

Effect: schrijven. 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

Voegt bibliotheeknummers toe aan een afspeellijst van de Muziek-app, in de opgegeven volgorde. Zonder confirm geeft het een voorbeeld terug en voegt het niets toe; geef confirm=true mee om toe te voegen. `playlist` is een naam of een id; als geen afspeellijst die naam heeft, maakt create=true hem aan, en zonder wordt er niets toegevoegd. Slimme afspeellijsten, mappen en afspeellijsten die de Muziek-app zelf beheert worden geweigerd. Als een nummer-id niet in de bibliotheek staat, wordt er niets toegevoegd. Een nummer dat al in de afspeellijst staat, wordt opnieuw toegevoegd. 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 een expliciete bevestigingsparameter. Controleer het voorbeeld en autoriseer de echte bewerking volgens het platformcontract.

Canoniek technisch schema in het Engels — macOS
{
  "properties": {
    "confirm": {
      "description": "Must be true to act. Without it, returns a preview and changes nothing.",
      "type": "boolean"
    },
    "create": {
      "description": "Create the playlist when none has that name (default false).",
      "type": "boolean"
    },
    "playlist": {
      "description": "Playlist name or id from music_list_playlists.",
      "type": "string"
    },
    "track_ids": {
      "description": "Track ids from music_search_library (at most 100).",
      "items": {
        "type": "string"
      },
      "type": "array"
    }
  },
  "required": [
    "playlist",
    "track_ids"
  ],
  "type": "object"
}

Documentatievoorbeeld

Documentatievoorbeeld voor music_add_to_playlist. 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.

{
  "confirm": false,
  "create": true,
  "playlist": "Demo Focus",
  "track_ids": [
    "demo-track-001",
    "demo-track-002"
  ]
}