music_playback

macOS

Objectif

Contrôle la lecture dans l’app Musique. action : play (reprend ; avec `track_id` il lit ce morceau de la bibliothèque, avec `playlist` cette liste de lecture), pause, next, previous, ou volume (règle `volume`, de 0 à 100). Appelé sans confirm, il renvoie un aperçu et ne change rien ; passez confirm=true pour l’exécuter. Renvoie ensuite l’état du lecteur, le volume et le morceau en cours. pause, next, previous et volume ne font rien lorsque l’app Musique n’est pas ouverte ; play l’ouvre.

Entrées requises

• action

Les noms restent exactement ceux exigés par l’outil. Les définitions techniques canoniques en anglais figurent dans le schéma dépliable ci-dessous.

Autorisations et confirmation

Le schéma déclare un paramètre de confirmation explicite. Vérifiez l’aperçu et autorisez l’opération réelle conformément au contrat de la plateforme.

• Utilisez uniquement les applications, comptes et ressources autorisés par l'utilisateur sur cette plateforme. Consultez la description spécifique à la plate-forme de cet outil pour connaître ses exigences de connexion et d'autorisation ; ce catalogue ne revendique pas d'étendues OAuth ou de droits d'exploitation supplémentaires pour le système d'exploitation.

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

Exemple documentaire

Exemple de documentation pour music_playback. N’exécutez pas cet exemple. Les arguments présentés appartiennent à un jeu de données fictif ; résolvez les identifiants réels et obtenez une autorisation avant tout appel réel.

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