Блог

VOD файлдарынан 24/7 HLS арнасын құру: ағынды не бұзады

Осы бетте

Бейне кітапханасынан құрылған сызықтық арнаны жиі сұрайды:

  • киноклуб өз сайтында кешкі эфир болғанын қалайды
  • онлайн мектеп дәрістердің тәулік бойы қайталанып тұрғанын қалайды
  • бренд өз бейнелерінің дүкендегі экрандарда шеңбер бойынша ойнағанын қалайды

Олардың ешқайсысында live энкодер жоқ. Оларда тек жүктелген файлдар бар. Соған қарамастан олар мынаны қалайды:

  • әр көрермен бір сәтте бір нәрсені көреді
  • хабар 20:00-де басталады
  • ойнатқыштың жанында «қазір / келесі» блогы тұрады

HLS — жай ғана сегменттердің плейлистері. Сондықтан алғашқы ой қарапайым: бірінші бейненің сегменттерін, содан кейін екіншісінің, кейін үшіншісінің сегменттерін алу. Оларды үнемі өсіп отыратын және ешқашан #EXT-X-ENDLIST алмайтын бір live-плейлист ретінде беру. Сегменттер келіп тұрса болғаны, олардың қайдан келетіні ойнатқышқа бәрібір.

Бұл барлық бейне бірдей болып, бағдарламаға ешкім тиіспегенше жұмыс істейді. Төменде нақты кітапханамен бізде не бұзылғанын және dodocast-тағы 24/7 арнада оны қалай шешкенімізді жаздық.

Біздің Open Movies 24/7 демо арнамыз dodocast-та жұмыс істейді: алты қысқа фильм (CC BY лицензиясымен Blender Foundation-ның ашық фильмдері және NASA роликі) 22 минуттық шеңберде ойнайды, ал күн сайын UTC бойынша 20:00-де "Caminandes marathon" хабары басталады. Ағын ашық, төмендегі мысалдар соны пайдаланады.

Демо арнаның беті: қазір эфирде, келесі, 6 бейнеден тұратын шеңбер (22:04) және UTC бойынша 20:00-дегі Caminandes marathon хабары

Master-плейлист — бүкіл сеансқа арналған шарт

Live ағында ойнатқыш медиа-плейлистерді қайта-қайта оқып отырады. Master-плейлистті ол тек бір рет, ойнату басталғанда оқиды. Сол сәттен бастап ол master-плейлист жариялаған нәрсеге сенеді: сапаларға (renditions), ажыратымдылықтарға, кодектерге, аудио топтарына және субтитр топтарына. Түсіндірме мысал:

m3u8
#EXTM3U
#EXT-X-MEDIA:TYPE=AUDIO,GROUP-ID="aud",LANGUAGE="en",NAME="English",DEFAULT=YES,URI="audio/en.m3u8"
#EXT-X-MEDIA:TYPE=AUDIO,GROUP-ID="aud",LANGUAGE="es",NAME="Español",URI="audio/es.m3u8"
#EXT-X-MEDIA:TYPE=SUBTITLES,GROUP-ID="subs",LANGUAGE="en",NAME="English",URI="subs/en.m3u8"
#EXT-X-STREAM-INF:BANDWIDTH=5000000,RESOLUTION=1920x1080,CODECS="avc1.640028,mp4a.40.2",AUDIO="aud",SUBTITLES="subs"
1080p/index.m3u8
#EXT-X-STREAM-INF:BANDWIDTH=2800000,RESOLUTION=1280x720,CODECS="avc1.64001f,mp4a.40.2",AUDIO="aud",SUBTITLES="subs"
720p/index.m3u8

Бір бейнеде мұны ешқашан байқамайсыз. Арнада ойнату барысында эфирге шығатын әр бейне master-плейлист жариялаған нәрсеге сай келуі керек. Нақты кітапхана сай келмейді:

  • кейбір бейнелер 1080p-де жүктелген, кейбірі тек 720p-де
  • бір фильм 2.39:1, қалғандары 16:9
  • тағы бірінде испан жолы жоқ

Ойнатқыш 1080p ойнатып тұрса, ал келесі бейнеде 1080p болмаса, ойнатқышқа жүктейтін ештеңе қалмайды.

Сондықтан dodocast арнасының тұрақты пішімі бар. Пішім арна қай сапаларды тарататынын (240p-ден 1080p-ге дейін) және олардың бәріне ортақ бір кадр пропорциясын анықтайды. Сай келмейтін бейне бағдарламаға кірмейді. Бұл қазір көріп отырғандардың бәрі үшін бұзылған ағыннан жақсы. Консоль себебін көрсетеді:

БелгіМағынасы
"missing 1080p"Бейнеде арна жариялаған сапа жоқ.
"1080p encoding…"Бейне жаңа ғана жүктелді, оның 1080p кодтауы әлі аяқталған жоқ. Кодтау біткенде бейне сай келеді.
"too wide"Оның кадры арнаның кадрынан кеңірек, мысалы 16:9 арнадағы 2.39:1 фильм.

CODECS ішіндегі avc1.640028 H.264 High профилі, 4.0 деңгейі дегенді білдіреді. Браузер осы мәнді оқып, декодері бейнені ойната ала ма, соны шешеді. Арна тек қазір бағдарламада тұрған бейнелердің деңгейін жарияласа, кейін қосылған ауырырақ бейне кейбір құрылғыларда ойнамай қалуы мүмкін. Сондықтан арна аздаған қоры бар жоғарғы шекті жариялайды (консольде ол "Codec level headroom" — кодек деңгейінің қоры — деп аталады). Эфир кезінде қосылған бейне осы шектен шықпайды. Өте ескі құрылғылар жоғары жарияланған деңгейден бас тартады. Олар сіз үшін маңызды болса, қорды өшіруге болады, бірақ сонда ауырырақ бейнелермен байланысты тәуекел қайта оралады.

AUDIO және SUBTITLES топтары да осылай жұмыс істейді. Арна ағылшын және испан тілдерін жариялады делік, ал келесі бейнеде тек ағылшын тілі бар. Испан тілін таңдаған көрермен не еститінін біреу шешуі керек. Біз бұл шешімді арна иесіне қалдырдық. Арна иесі арна қай тілдерді уәде ететінін белгілейді. Бұл тілдері жоқ бейнелер үшін ол екі нұсқаның бірін таңдайды: бейненің әдепкі жолына ауысу немесе бейнені эфирге жібермеу. Субтитр жарияламасаңыз, бейнелерде субтитр болса да, ойнатқыш ешқандай субтитр көрсетпейді.

Осы себепті пішімді, субтитр тілдерін және шифрлау кілтін тек арна өшіп тұрғанда өзгертуге болады.

Бағдарламаны ағынды үзбей өзгерту

Бағдарлама да өзгереді. Адамдар жаңа бейнелер қосады, ескілерін алып тастайды, қалғандарының ретін ауыстырады және мұны эфирде жасағысы келеді. Өзгеріс бірден қолданылса, бір бейненің ортасында отырған көрермен басқа бейненің кездейсоқ нүктесіне түсіп қалады.

dodocast-та өзгеріс бағдарламаның жаңа нұсқасын жариялайды. Жаңа нұсқа бейнелер арасындағы келесі шекарада күшіне енеді. Оған дейін алдыңғы нұсқа ойнай береді. Консоль "Edit takes effect at 9:36 PM" деп көрсетеді және бейнелерді "added" (қосылды) немесе "removed" (алынды) деп белгілейді. Көрермен жай ғана келесі бейненің басталғанын көреді.

Эфирдегі демо арнаның Program қойындысы: алты бейне, 22:04 шеңбер, әр бейненің келесі эфир уақыты

Шеңбердің үстіндегі кесте

Бағдарлама — шексіз жүретін шеңбер. Бірақ теледидар сағатқа қарап жұмыс істейді: 20:00-де марафон, жұмыс күндері 09:00-де дәрістер. Сондықтан хабарлар шеңбердің үстіндегі кестеде тұрады.

Хабар — белгіленген уақыттағы бейне немесе тұтас плейлист: бір рет, күн сайын немесе таңдалған апта күндері. Хабар 1-ден 1 440 минутқа дейін созылады. Материал ұзынырақ болса, арна оны қияды. Қысқарақ болса, арна қалған уақытты толтырмамен толтырады. Хабарлар бір-бірімен қабаттаса алмайды.

Хабар уақыты арнаның уақыт белдеуі бойынша беріледі. Сондықтан «күн сайын 20:00-де» жазғы уақытқа ауысқаннан кейін де 20:00 болып қалады. Ол жылына екі рет бір сағатқа жылжымайды.

Хабар аяқталғанда шеңбер не істейтінін де шешуге тура келді. Жалғыз дұрыс жауап болмады, сондықтан бұл — арна баптауы:

НұсқаХабардан кейінНеге ыңғайлы
"From the start" (басынан)Шеңбер басынан басталады.толық көрсетілгені жөн қысқа толтырма бағдарлама
"Continue" (жалғастыру)Шеңбер хабар үзген жерінен жалғасады.басының қайталанғаны жалықтыратын ұзақ бағдарлама
"Background air" (фондық эфир)Шеңбер осы уақыт бойы жүріп тұрды. Хабар жай оның үстінен ойнады.фоны өз сағатымен жүретін «нағыз теледидар» арнасы

Кестені де эфирде өзгертуге болады. Арна кестені бір минут ішінде қайта есептейді. Көрермендер өзгерісті келесі эфирден бастап көреді.

Демо арнаның Schedule қойындысы: UTC уақыт белдеуі, хабарлар арасында Continue, Caminandes marathon хабары

EPG және шифрлау

Сайттағы арнаның жанында әрдайым дерлік «қазір эфирде» блогы немесе телебағдарлама керек. Арна өзінің ағымдағы күйін және телебағдарламасын CORS ашық JSON түрінде жариялайды. Сондықтан оларды тікелей браузерден сұрай аласыз, ойнатқышты парсинг жасаудың қажеті жоқ. Төмендегі екі сұрау да демо арнада жұмыс істейді.

Консольдегі арнаның Overview қойындысындағы Channel data as JSON блогы, екі сілтемесімен

Күй қазір қай бейне эфирде, қайсысы келесі және келесі хабар қашан басталатынын айтады:

bash
curl "https://stream.dodocast.com/public/ch/cBlTOROrQI"

Қысқартылған жауап:

json
{
  "title": "Open Movies 24/7",
  "state": "ON",
  "currentItem": { "title": "Wing It!", "startsAtMs": 1795088122186, "endsAtMs": 1795088360080 },
  "nextItem": { "title": "Big Buck Bunny", "startsAtMs": 1795088360080, "endsAtMs": 1795088994505 },
  "nextShow": { "title": "Caminandes marathon", "startsAtMs": 1795118400000, "endsAtMs": 1795118820000 }
}
Толық жауап
json
{
  "code": "cBlTOROrQI",
  "title": "Open Movies 24/7",
  "description": null,
  "tags": [],
  "state": "ON",
  "serverTimeMs": 1795088315571,
  "itemCount": 6,
  "totalDurationMs": 1324106,
  "encrypted": false,
  "poster": "https://stream.dodocast.com/preview/xOa9tZc7QO/cover.jpg?v=4ed796473e0a3fba01e92351074b25f147caa1eb3c33a090f026009ec0a356e1",
  "currentItem": { "code": "xOa9tZc7QO", "title": "Wing It!", "durationMs": 237894, "startsAtMs": 1795088122186, "endsAtMs": 1795088360080 },
  "nextItem": { "code": "x10F5HR9Zt", "title": "Big Buck Bunny", "durationMs": 634425, "startsAtMs": 1795088360080, "endsAtMs": 1795088994505 },
  "currentShow": null,
  "nextShow": { "title": "Caminandes marathon", "startsAtMs": 1795118400000, "endsAtMs": 1795118820000 },
  "access": { "type": "PUBLIC", "granted": true, "requiresPassword": false },
  "embedding": { "policy": "ALL", "domains": [] },
  "theme": { "colorPrimary": "indigo", "colorNeutral": "zinc" },
  "watchLayout": "LIVE_STAGE",
  "sources": {
    "mp4": "https://stream.dodocast.com/ch/mp4/cBlTOROrQI/master.m3u8",
    "ts": "https://stream.dodocast.com/ch/ts/cBlTOROrQI/master.m3u8"
  }
}

Төмендегі CodePen мысалы тек осы сұрауды және hls.js-ті пайдаланады. Ойнатқыш демо арнаны ойнатады, ал оның астындағы блок бейне аяқталған сайын жаңарады.

Тірі мысалды CodePen-де ашу →Демо арнаның ойнатқышы және арна күйінің JSON-ынан жасалған «қазір / келесі» блогы (hls.js, SDK-сыз).

Телебағдарлама шеңбердегі бейнелерді емес, тек кесте бойынша хабарларды тізеді. Әдепкі бойынша ол алдағы 24 сағатты қамтиды; from және to параметрлерімен (Unix уақыты, миллисекундпен) екі аптаға дейін қамти алады. Мына сұрау алдағы жеті күнді алады:

bash
FROM=$(date +%s)000; TO=$(( $(date +%s) + 7*86400 ))000
curl "https://stream.dodocast.com/public/ch/cBlTOROrQI/epg?from=$FROM&to=$TO"
Жауап (жеті жазбаның алғашқы екеуі)
json
{
  "code": "cBlTOROrQI",
  "title": "Open Movies 24/7",
  "serverTimeMs": 1795089367508,
  "entries": [
    { "startsAtMs": 1795118400000, "endsAtMs": 1795118820000, "title": "Caminandes marathon", "poster": "https://stream.dodocast.com/preview/V0bfQXjss9/cover.jpg?v=c8225aa7388e60b3bb82adc7856d621fb44a85a410c2e6fe338fa7eac95b2bf3", "subtitles": [] },
    { "startsAtMs": 1795204800000, "endsAtMs": 1795205220000, "title": "Caminandes marathon", "poster": "https://stream.dodocast.com/preview/V0bfQXjss9/cover.jpg?v=c8225aa7388e60b3bb82adc7856d621fb44a85a410c2e6fe338fa7eac95b2bf3", "subtitles": [] }
  ]
}

Player SDK мұны дайын түрде ұсынады. getChannelState() қазір және келесі эфирде не барын қайтарады, getChannelGuide() екі аптаға дейінгі телебағдарламаны қайтарады, ал progress() ағымдағы хабардың қаншасы өткенін айтады.

Бағдарламада шифрланған және шифрланбаған бейнелер де оңай араласып кетеді. Әр бейне өз кілтін әкелсе, ойнатқыш әр шекарада кілт ауыстырады. Шифрланған ағынның ортасындағы ашық бейне тесік қалдырады. Сондықтан арнаның өз кілті бар. Арна әр бейненің шифрлау баптауларын елемейді және сегменттерді жеткізу кезінде шифрлайды. AES-128 және SAMPLE-AES кездейсоқ жүктеп алудан қорғайды. Олар DRM емес, және сайт мұны ашық айтады.

Арна әзірге не істемейді

  • камерадан немесе энкодерден тікелей сигнал қабылдау
  • ағынға жарнамалық үзілістер қою (SCTE-35)
  • көрермендерге арнаны артқа айналдыруға мүмкіндік беру (DVR)

Premiere режиміндегі бір реттік трансляцияда көрермендер оның басына дейін артқа айналдыра алады, бірақ алға өткізе алмайды.

dodocast-қа 2 минуттық шолу осының бәрін консольде көрсетеді. Біздің тегін HLS ойнатқышымыз кез келген HLS ағынының ішінде не барын көрсетеді: оның сапаларын, CODECS мәнін және жолдарын. Ол ағынды hls.js арқылы да, браузердің кіріктірілген ойнатқышымен де ойната алады, сондықтан екеуін салыстыруға болады.

Біз dodocast-ты жасаймыз — хостинг, 24/7 арналар және кесте бойынша трансляциялар үшін бейне платформасы. VOD-тан сызықтық HLS құру туралы сұрақтарыңызды hello@dodocast.com мекенжайына жазыңыз.

← Барлық мақалалар