Naar de inhoud
Alle hulpmiddelen

music_playback

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

Bedient het afspelen in de Muziek-app. action: play (hervat; met `track_id` speelt het dat bibliotheeknummer af, met `playlist` die afspeellijst), pause, next, previous of volume (stelt `volume` in, 0 tot 100). Zonder confirm geeft het een voorbeeld terug en wijzigt het niets; geef confirm=true mee om het uit te voeren. Geeft daarna de spelerstatus, het volume en het huidige nummer terug. pause, next, previous en volume doen niets wanneer de Muziek-app niet open is; play opent hem.

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": {
    "action": {
      "description": "What to do.",
      "enum": [
        "play",
        "pause",
        "next",
        "previous",
        "volume"
      ],
      "type": "string"
    },
    "confirm": {
      "description": "Must be true to act. Without it, returns a preview and changes nothing.",
      "type": "boolean"
    },
    "playlist": {
      "description": "With play: a playlist name or id from music_list_playlists.",
      "type": "string"
    },
    "track_id": {
      "description": "With play: a track id from music_search_library.",
      "type": "string"
    },
    "volume": {
      "description": "With volume: 0 to 100.",
      "type": "integer"
    }
  },
  "required": [
    "action"
  ],
  "type": "object"
}

Documentatievoorbeeld

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

{
  "action": "play",
  "confirm": false,
  "playlist": "Demo Focus"
}