music_playback

macOS

Scopo

Controlla la riproduzione nell'app Music. action: play (riprende; con `track_id` riproduce quel brano della libreria, con `playlist` quella playlist), pause, next, previous oppure volume (imposta `volume`, da 0 a 100). Chiamato senza confirm restituisce un'anteprima e non cambia nulla; passa confirm=true per eseguirlo. Restituisce poi lo stato del lettore, il volume e il brano corrente. pause, next, previous e volume non fanno nulla quando l'app Music non è aperta; play la apre.

Input obbligatori

• action

I nomi restano esattamente quelli richiesti dallo strumento. Le definizioni tecniche canoniche in inglese sono nello schema espandibile qui sotto.

Autorizzazioni e conferma

Lo schema dichiara un parametro di conferma esplicito. Controlla l’anteprima e autorizza l’operazione reale secondo il contratto della piattaforma.

• Utilizza solo le app, gli account e le risorse autorizzate dall'utente su questa piattaforma. Consulta la descrizione specifica della piattaforma di questo strumento per i suoi requisiti di connessione e autorizzazione; questo catalogo non afferma ambiti OAuth aggiuntivi o diritti del sistema operativo.

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

Esempio documentale

Esempio di documentazione per music_playback. Non eseguire questo esempio. Gli argomenti mostrati appartengono a un set di dati fittizio; individua gli identificatori reali e ottieni l’autorizzazione prima di una chiamata reale.

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