Перейти к содержимому
Все инструменты

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