本文へスキップ
すべてのツール

music_search_library

ミュージック · macOS

効果: 読み取り. 状態: 条件付き提供.

「条件付き提供」は、バージョン、プラットフォーム、権限、アカウント、設定に依存する可能性を示し、すべての環境で有効という意味ではありません。

macOS

目的

ユーザーの Music ライブラリのトラックを検索します。`field` で検索対象を title、artist、album に絞り込めます。既定の any は、Music アプリ自身の検索と同じく、すべてのテキストフィールドを検索します。各トラックの id、タイトル、アーティスト、アルバム、長さを返します。この id は music_playback と music_add_to_playlist が受け取ります。検索対象はライブラリだけで、Apple Music のカタログは検索しません。Music アプリが閉じている場合は開きます。

必須入力

入力名はツールが要求する正確な形式のままです。英語の正規技術定義は下の展開可能なスキーマにあります。

権限と確認

スキーマには明示的な確認パラメータがありません。これは無許可の操作を認めるものではありません。効果を確認し、承認を得てください。

英語の正規技術スキーマ — macOS
{
  "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"
}