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

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