music_search_library

macOS

用途

搜索用户 Music 资料库中的曲目。`field` 将搜索范围缩小到 title、artist 或 album；默认值 any 会搜索 Music 应用自带搜索所覆盖的每个文本字段。返回每首曲目的 id、标题、艺术家、专辑和时长；该 id 正是 music_playback 和 music_add_to_playlist 所需要的。只搜索资料库，不搜索 Apple Music 曲库。Music 应用关闭时会将其打开。

必填输入

• query

输入名称会严格保持工具要求的形式。下方可展开的架构中保留英文规范技术定义。

权限与确认

架构未声明明确的确认参数。这并不代表可以未经许可操作；请检查效果并取得授权。

• 仅使用用户在此平台上授权的应用、账户和资源。请查阅此工具针对平台的说明，以了解其连接和权限要求；本目录不声称需要额外的 OAuth 范围或操作系统授权。

{
  "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"
}