Insert
MediaPlaylistЧто это
Exec-функция для вставки медиа-источника (MediaSource) в плейлист по указанному индексу. Если индекс некорректен, функция может не выполнить вставку. Возвращает успешность операции.
Пины
Exec-входы:
- execute (exec) — запуск функции
Exec-выходы:
- then (exec) — продолжение выполнения
Входы (данные):
- Target (MediaPlaylist Object Reference) — целевой плейлист, в который вставляется элемент
- MediaSource (MediaSource Object Reference) — вставляемый медиа-источник
- Index (Integer) — позиция вставки (0 — начало, -1 — в конец, но обычно используются неотрицательные значения)
Выходы (данные):
- Return Value (Boolean) — true, если вставка выполнена успешно, иначе false
Когда используется
При динамическом формировании плейлиста во время выполнения — например, вставка рекламного ролика в середину очереди, добавление трека по запросу пользователя или перестроение порядка воспроизведения.
Типичные проблемы
- Некорректный индекс — передача отрицательного индекса (кроме -1) или индекса, превышающего размер плейлиста, может привести к пропуску вставки без ошибки. Всегда проверяйте индекс перед вызовом.
- Null MediaSource — если передать недействительную ссылку на медиа-источник, операция завершится неудачей (Return Value = false). Убедитесь, что объект существует и загружен.
- Игнорирование Return Value — хотя функция exec, не стоит забывать проверять возвращаемое значение, чтобы убедиться, что вставка действительно произошла (например, при отладке).