music_playback

macOS

Zweck

Steuert die Wiedergabe in der Musik-App. action: play (setzt fort; mit `track_id` spielt es diesen Bibliothekstitel, mit `playlist` diese Playlist), pause, next, previous oder volume (setzt `volume`, 0 bis 100). Ohne confirm gibt es eine Vorschau zurück und ändert nichts; übergeben Sie confirm=true, um es auszuführen. Gibt anschließend den Player-Zustand, die Lautstärke und den aktuellen Titel zurück. pause, next, previous und volume tun nichts, wenn die Musik-App nicht geöffnet ist; play öffnet sie.

Erforderliche Eingaben

• action

Die Namen bleiben exakt so erhalten, wie das Werkzeug sie verlangt. Die kanonischen technischen Definitionen auf Englisch stehen im ausklappbaren Schema unten.

Berechtigungen und Bestätigung

Das Schema deklariert einen ausdrücklichen Bestätigungsparameter. Prüfen Sie die Vorschau und autorisieren Sie den echten Vorgang gemäß Plattformvertrag.

• Verwenden Sie auf dieser Plattform nur die vom Benutzer autorisierten Apps, Konten und Ressourcen. Informationen zu den Verbindungs- und Berechtigungsanforderungen finden Sie in der plattformspezifischen Beschreibung dieses Tools. Dieser Katalog beansprucht keine zusätzlichen OAuth-Bereiche oder Betriebssystemberechtigungen.

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

Dokumentationsbeispiel

Dokumentationsbeispiel für music_playback. Führen Sie dieses Beispiel nicht aus. Die gezeigten Argumente gehören zu einem fiktiven Datensatz; ermitteln Sie reale Kennungen und holen Sie vor einem echten Aufruf die Genehmigung ein.

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