ЯзыкРусский

Статьи

Формат плейлиста M3U: как прочитать список каналов

Прочтите пример аннотированного плейлиста M3U, изучите поля EXTINF и tvg-id и безопасно проверьте URL-адреса каналов перед импортом собственного плейлиста.

Издатель InoxTV · Опубликовано

Последнее обновление

Формат списка воспроизведения M3U представляет собой текст, описывающий мультимедийные записи и места их поиска. Прочитав небольшой пример, вы сможете отличить проблему каталога от проблемы воспроизведения перед изменением настроек приложения. Приведенный ниже пример намеренно вымышленный: его зарезервированный домен не является источником телевидения, и его копирование в плеер не обеспечит рабочие каналы.

Начните с небольшого, понятного примера

#EXTM3U
#EXTINF:-1 tvg-id="demo.news" group-title="Examples",Example News
https://media.example.com/news/index.m3u8
#EXTINF:-1 tvg-id="demo.documentary" group-title="Examples",Example Documentary
https://media.example.com/documentary/index.m3u8

В первой строке объявляется расширенный файл M3U. Каждая запись имеет строку описательной информации, за которой следует адрес. В этом примере адреса указывают на списки воспроизведения HLS, но запись M3U не обязательно должна заканчиваться этим расширением. Адрес может представлять другой поддерживаемый формат мультимедиа или конечную точку сервера, которая возвращает медиафайл без очевидного имени файла.

Открывайте копию в текстовом редакторе при проверке файла, которым вы владеете или имеете право использовать. Избегайте текстовых процессоров, которые меняют кавычки или сохраняют документ с дополнительным форматированием. Сохраните исходный файл, чтобы эксперимент с меткой не стал единственной копией вашего рабочего списка.

Что говорят описательные поля

Строка EXTINF содержит информацию, связанную со следующей записью. Во многих каталогах IPTV продолжительность минус единица представляет запись без известной фиксированной продолжительности. Текст после запятой — это отображаемое имя. Атрибуты перед ним представляют собой соглашения, используемые конкретными плеерами и поставщиками; их поддержка не одинакова во всех приложениях.

Пример поляЦельЧто оно не может доказать
tvg-id="demo.news"Идентификатор канала, который может быть связан с данными телегида.Существует соответствующая запись телегида.
group-title="Examples"Рекомендуемая категория для организации записейВсе плееры одинаково интерпретируют группы
Example NewsЧитаемое название каналаЧто поток онлайн или лицензирован
Следующий URL-адресМесто, запрошенное для воспроизведенияУчетной записи разрешен доступ к нему

Адрес логотипа, если он присутствует, является еще одним ресурсом, который может запросить интерфейс. Поэтому отсутствие изображения не обязательно означает, что видео повреждено. Точно так же правильно отображаемый логотип не является тестом воспроизведения. Разделение имен, иллюстраций, идентификаторов и адресов видео делает ваши наблюдения более точными.

Список каналов может указывать на другой список воспроизведения

Это нормально, что внешний каталог содержит адреса, ответы на которые сами являются списками воспроизведения. Внешний список отвечает, какой канал выбрал зритель. Манифест HLS может затем описывать воспроизведение мультимедиа или последовательность небольших сегментов, используемых для доставки этого канала. Это разные слои, даже если оба используют связанный текстовый синтаксис.

По этой причине наличия суффикса M3U8 недостаточно, чтобы решить, принадлежит ли URL-адрес импортеру каталога или медиаплееру. Сравнение M3U и HLS объясняет различия тегов. Следуйте инструкциям из вашего авторизованного источника, а не меняйте расширения файлов, пока импортер не примет их.

Проверьте идентификаторы, если телегид пуст

В вымышленном примере идентификатор demo.news может соответствовать каналу, объявленному в телегиде XMLTV. Записи программы ссылаются на этот идентификатор канала телегида. Если вместо этого в источнике используется demo.news.hd, схожие отображаемые имена не обязательно приводят к совпадению. Точное соответствие зависит от приложения и соглашений источника.

Прежде чем редактировать идентификаторы, сравните каталог и телегид, которые предназначены для совместной работы. В фиде для конкретного региона может использоваться идентификатор, отличный от национального фида с похожим названием. Широкая замена имен в большом файле может привести к неправильным совпадениям. Прежде чем менять полный список, поработайте над одним понятным примером и прочтите как работает сопоставление XMLTV.

Проверьте структуру, не раскрывая учетную запись

URL-адрес может содержать учетные данные как в пути, так и после вопросительного знака. Недостаточно удалить только значение параметра password. Токен, номер счета или подписанный адрес могут быть где-то еще. При подготовке примера для поддержки замените полное адрес зарезервированным адресом примера и отдельно опишите ответ или ошибку.

Не загружайте частный плейлист в онлайн-форматер или валидатор только потому, что он предлагает удобный предварительный просмотр. Загруженный каталог может раскрывать каждый адрес потока, связанный с учетной записью. Храните резервные копии в хранилище, которым вы управляете, и учитывайте, кто может получить доступ к синхронизированной папке. руководство по конфиденциальности плейлистов включает практический список проверок перед удалением приватных данных.

Определите, что можно исправить, а что нельзя исправить

Копия в виде обычного текста может содержать неполный адрес, случайный разрыв строки или страницу входа в формате HTML, сохраненную с расширением M3U. Это полезные выводы. Однако синтаксически правдоподобный файл все равно может указывать на недоступные медиаданные. Изменение имени группы, идентификатора или суффикса файла не может продлить учетную запись, обойти ограничение сервера или предоставить разрешение на просмотр контента.

Если каталог загружается, но одна запись дает сбой, запишите, работают ли другие записи и происходит ли сбой в том же авторизованном потоке в другой совместимой настройке. Если сам каталог не импортируется, сохраните исходный ответ и ознакомьтесь с руководством по загрузке плейлиста. Как только структура будет понятна, Руководство по настройке InoxTV M3U предоставит фактические шаги импорта.

Проверка одной записи на копии

Для самостоятельной проверки возьмите копию собственного файла и выберите одну запись. Сначала найдите строку с ее названием, затем следующую строку с адресом. Убедитесь, что длинный адрес не был разбит на две строки при копировании из сообщения. Перенос, который редактор показывает только на экране, и настоящий перевод строки в файле — разные вещи. Не удаляйте символы наугад: сравните копию с исходными данными поставщика. Затем отдельно отметьте группу и идентификатор телегида. Если название отображается правильно, но программы отсутствуют, проверка адреса видео сама по себе не объяснит отсутствие расписания. Такая небольшая проверка позволяет сформулировать точный вопрос: не читается весь файл, не находится одна запись или не работает уже выбранный поток. Перед любым изменением сохраните исходную копию в безопасном месте.

Ссылки и дополнительная литература

Частые вопросы

Является ли каждый файл M3U списком телевизионных каналов?
Нет. M3U может описывать другие медиа, а плейлист HLS может описывать сегменты одной презентации. Прочитайте содержимое файла, а не принимайте решение только по его имени.
Может ли изменение названия канала восстановить поток?
Обычно нет. Отображаемое имя идентифицирует запись в интерфейсе; адрес в следующей строке — это то, что запрашивает плеер. Переименование записи не устраняет отсутствующий или неавторизованный источник.
Должен ли я публиковать плейлист при обращении за помощью?
Нет. Адреса потоков и URL-адреса списков воспроизведения могут содержать данные доступа к учетной записи. Используйте вымышленный пример, который сохранит структуру и удалите реальные хосты, имена пользователей, пароли и токены.