Модуль ngx_http_hls_module

• Пример конфигурации
• Директивы
• hls
• hls_buffers
• hls_forward_args
• hls_fragment
• hls_mp4_buffer_size
• hls_mp4_max_buffer_size

Модуль ngx_http_hls_module предоставляет поддержку потоковой передачи HTTP Live Streaming (HLS) на стороне сервера для файлов медиа данных MP4 и MOV. Такие файлы обычно имеют расширения .mp4, .m4v, .m4a, .mov, или .qt. Модуль поддерживает кодек видео H.264, аудио кодеки AAC и MP3.

Для каждого файла медиа поддерживаются два URI:

• URI плейлиста с расширением файла “.m3u8”. URI может принимать необязательные аргументы:
  • “start” и “end” определяют границы плейлиста в секундах (1.9.0).
  • “offset” смещает начальную позицию воспроизведения на заданный временной сдвиг в секундах (1.9.0). Положительное значение устанавливает временной сдвиг от начала плейлиста. Отрицательное значение устанавливает временной сдвиг от конца последнего фрагмента в плейлисте.
  • “len” определяет длину фрагмента в секундах.
• URI фрагмента с расширением файла “.ts”. URI может принимать необязательные аргументы:
  • “start” и “end” определяют границы фрагмента в секундах.

Этот модуль доступен в рамках нашей коммерческой подписки.

Пример конфигурации

location / {
    hls;
    hls_fragment            5s;
    hls_buffers             10 10m;
    hls_mp4_buffer_size     1m;
    hls_mp4_max_buffer_size 5m;
    root /var/video/;
}

С этой конфигурацией поддерживаются следующие URI для файла “/var/video/test.mp4”:

http://hls.example.com/test.mp4.m3u8?offset=1.000&start=1.000&end=2.200
http://hls.example.com/test.mp4.m3u8?len=8.000
http://hls.example.com/test.mp4.ts?start=1.000&end=2.200

Директивы

Включает потоковую передачу HLS в данном месте.

Устанавливает максимальный number и size буферов, используемых для чтения и записи кадров данных.

Добавляет аргументы из запроса плейлиста к URI фрагментов. Это может быть полезно для выполнения авторизации клиента при запросе фрагмента или при защите потока HLS модулем ngx_http_secure_link_module.

Например, если клиент запросил плейлист http://example.com/hls/test.mp4.m3u8?a=1&b=2, аргументы a=1 и b=2 будут добавлены к URI фрагментов после аргументов start и end:

#EXTM3U
#EXT-X-VERSION:3
#EXT-X-TARGETDURATION:15
#EXT-X-PLAYLIST-TYPE:VOD

#EXTINF:9.333,
test.mp4.ts?start=0.000&end=9.333&a=1&b=2
#EXTINF:7.167,
test.mp4.ts?start=9.333&end=16.500&a=1&b=2
#EXTINF:5.416,
test.mp4.ts?start=16.500&end=21.916&a=1&b=2
#EXTINF:5.500,
test.mp4.ts?start=21.916&end=27.416&a=1&b=2
#EXTINF:15.167,
test.mp4.ts?start=27.416&end=42.583&a=1&b=2
#EXTINF:9.626,
test.mp4.ts?start=42.583&end=52.209&a=1&b=2

#EXT-X-ENDLIST

Если поток HLS защищен модулем ngx_http_secure_link_module, $uri не должен использоваться в выражении secure_link_md5, так как это вызовет ошибки при запросе фрагментов. Вместо $uri ($hls_uri в примере) следует использовать базовый URI:

http {
    ...

    map $uri $hls_uri {
        ~^(?<base_uri>.*).m3u8$ $base_uri;
        ~^(?<base_uri>.*).ts$   $base_uri;
        default                 $uri;
    }

    server {
        ...

        location /hls/ {
            hls;
            hls_forward_args on;

            alias /var/videos/;

            secure_link $arg_md5,$arg_expires;
            secure_link_md5 "$secure_link_expires$hls_uri$remote_addr secret";

            if ($secure_link = "") {
                return 403;
            }

            if ($secure_link = "0") {
                return 410;
            }
        }
    }
}

Определяет длину фрагмента по умолчанию для запрошенных URI плейлиста без аргумента “len”.

Устанавливает начальный size буфера, используемого для обработки файлов MP4 и MOV.

Во время обработки метаданных может потребоваться больший буфер. Его размер не должен превышать указанного size, в противном случае nginx вернёт ошибку сервера 500 (Внутренняя ошибка сервера) и запишет следующее сообщение:

"/some/movie/file.mp4" mp4 moov atom is too large:
12583268, you may want to increase hls_mp4_max_buffer_size