music_search_library

macOS

목적

사용자의 Music 라이브러리에서 트랙을 검색합니다. `field`는 검색을 title, artist 또는 album으로 좁히며, 기본값 any는 Music 앱 자체 검색과 같은 모든 텍스트 필드를 검색합니다. 각 트랙의 id, 제목, 아티스트, 앨범, 길이를 반환하며, id는 music_playback과 music_add_to_playlist가 받는 값입니다. 라이브러리만 검색하며 Apple Music 카탈로그는 검색하지 않습니다. Music 앱이 닫혀 있으면 엽니다.

필수 입력

• query

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

권한 및 확인

스키마에 명시적 확인 매개변수가 없습니다. 이는 무단 작업을 허용하지 않습니다. 효과를 검토하고 승인을 받으세요.

• 이 플랫폼에서는 사용자가 승인한 앱, 계정 및 리소스만 사용하세요. 연결 및 권한 요구 사항은 이 도구의 플랫폼별 설명을 참조하세요. 이 카탈로그는 추가 OAuth 범위나 OS 권한이 있다고 주장하지 않습니다.

{
  "properties": {
    "field": {
      "description": "Where to look (default any).",
      "enum": [
        "any",
        "title",
        "artist",
        "album"
      ],
      "type": "string"
    },
    "limit": {
      "description": "Tracks to return (default 25, max 100).",
      "maximum": 100,
      "minimum": 1,
      "type": "integer"
    },
    "query": {
      "description": "Text to look for.",
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "type": "object"
}

문서 예시

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

{
  "field": "title",
  "limit": 10,
  "query": "Moonlight Sonata"
}