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

music_add_to_playlist

음악 · macOS

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

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

macOS

목적

Music 앱의 플레이리스트에 라이브러리 트랙을 지정한 순서대로 추가합니다. confirm 없이 호출하면 미리보기를 반환하며 아무것도 추가하지 않고, confirm=true를 전달하면 추가합니다. `playlist`는 이름 또는 id입니다. 해당 이름의 플레이리스트가 없으면 create=true가 새로 만들고, 없으면 아무것도 추가되지 않습니다. 스마트 플레이리스트, 폴더, Music 앱이 관리하는 플레이리스트는 거부됩니다. 트랙 id 중 라이브러리에 없는 것이 있으면 아무것도 추가되지 않습니다. 이미 플레이리스트에 있는 트랙은 다시 추가됩니다. Music 앱이 닫혀 있으면 엽니다.

필수 입력

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

권한 및 확인

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

영문 정식 기술 스키마 — macOS
{
  "properties": {
    "confirm": {
      "description": "Must be true to act. Without it, returns a preview and changes nothing.",
      "type": "boolean"
    },
    "create": {
      "description": "Create the playlist when none has that name (default false).",
      "type": "boolean"
    },
    "playlist": {
      "description": "Playlist name or id from music_list_playlists.",
      "type": "string"
    },
    "track_ids": {
      "description": "Track ids from music_search_library (at most 100).",
      "items": {
        "type": "string"
      },
      "type": "array"
    }
  },
  "required": [
    "playlist",
    "track_ids"
  ],
  "type": "object"
}

문서 예시

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

{
  "confirm": false,
  "create": true,
  "playlist": "Demo Focus",
  "track_ids": [
    "demo-track-001",
    "demo-track-002"
  ]
}