본문으로 건너뛰기
모든 도구

music_playback

음악 · macOS

효과: 쓰기. 상태: 조건부 제공.

‘조건부 제공’은 도구가 버전, 플랫폼, 권한, 계정 또는 설정에 따라 달라질 수 있음을 뜻하며 모든 설치에서 활성화되었다는 의미는 아닙니다.

macOS

목적

Music 앱의 재생을 제어합니다. action: play(재개, `track_id`가 있으면 해당 라이브러리 트랙을, `playlist`가 있으면 해당 플레이리스트를 재생), pause, next, previous, 또는 volume(`volume`을 0~100으로 설정). confirm 없이 호출하면 미리보기를 반환하며 아무것도 변경하지 않고, confirm=true를 전달하면 실행합니다. 이후의 플레이어 상태, 볼륨, 현재 트랙을 반환합니다. pause, next, previous, volume은 Music 앱이 열려 있지 않으면 아무 동작도 하지 않으며, play는 앱을 엽니다.

필수 입력

입력 이름은 도구가 요구하는 정확한 형태로 유지됩니다. 영문 정식 기술 정의는 아래 펼칠 수 있는 스키마에 있습니다.

권한 및 확인

스키마에 명시적 확인 매개변수가 있습니다. 미리보기를 검토하고 플랫폼 계약에 따라 실제 작업을 승인하세요.

영문 정식 기술 스키마 — 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"
}

문서 예시

music_playback 문서 예시입니다. 이 예시를 실행하지 마세요. 표시된 인수는 가상 데이터 세트에 속합니다. 실제 호출 전에 실제 식별자를 확인하고 승인을 받으세요.

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