music_playback

macOS

Propósito

Controla la reproducción en la app Música. action: play (reanuda; con `track_id` reproduce esa canción de la biblioteca, con `playlist` esa lista de reproducción), pause, next, previous o volume (establece `volume`, de 0 a 100). Si se llama sin confirm, devuelve una vista previa y no cambia nada; pasa confirm=true para hacerlo. Después devuelve el estado del reproductor, el volumen y la canción actual. pause, next, previous y volume no hacen nada cuando la app Música no está abierta; play la abre.

Entradas obligatorias

• action

Los nombres se conservan exactamente como los exige la herramienta. Las definiciones técnicas canónicas, en inglés, están en el esquema expandible de abajo.

Permisos y confirmación

El esquema declara un parámetro explícito de confirmación. Revisa la vista previa y autoriza la operación real según el contrato de esta plataforma.

• Utilice únicamente las aplicaciones, cuentas y recursos autorizados por el usuario en esta plataforma. Consulte la descripción específica de la plataforma de esta herramienta para conocer sus requisitos de conexión y permisos. Este catálogo no afirma alcances OAuth adicionales ni derechos de 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"
}

Ejemplo documental

Ejemplo de documentación para music_playback. No ejecutes este ejemplo. Los argumentos mostrados pertenecen a un conjunto de datos ficticio; resuelve identificadores reales y obtén autorización antes de una llamada real.

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