Playlist in formato M3U è un normale documento di testo con codifica UTF-8. Esso può essere modificato, ad esempio, utilizzando l'applicazione blocco Note dagli accessori di Windows. Qualsiasi file M3U inizia con la prima riga che contiene la scritta #EXTM3U. Di seguito, il file è un insieme di coppie di righe, il primo dei quali inizia sempre con #EXTINF:. E il secondo è un link al contenuto.
Un esempio di un file in formato M3U:
#EXTM3U
#EXTINF:0 tvg-name="BBC" audio-track="eng" tvg-logo="http://mylogos.domain/BBC.png", BBC World
http://server.name/stream/to/video2
#EXTINF:0 tvg-name="CNN" audio-track="rus", CNN International
http://server.name/stream/to/video2
#EXTINF:0, Arirang
http://server.name/stream/to/video3
Come si vede nell'esempio del file .m3u, è un insieme di righe che indicano la fonte del flusso (link) e dei vari parametri. Nell'esempio sono riportati 3 canali: BBC World, CNN International e Arirang.
La prima riga inizia sempre con #EXTINF:(durata) (attributi), (il nome del canale). I Parametri obbligatori sono: la durata e il nome del canale. In caso dei link live Tv la durata deve essere sempre 0 o -1.
Gli attributi sono opzionali, ecco un elenco di attributi che vengono utilizzati durante il caricamento playlist:
- tvg-shift - Spostamento del tempo del programma televisivo
- tvg-name - Id canale per EPG
- tvg-logo - logo del canale (url)
- audio-track - Il codice della lingua (ISO 639-2) tracce audio di un canale, ad esempio: eng, ita. È possibile specificare più tracce audio con una virgola (esempio rus, ukr, eng). Il primo impostato nella lista sarà definito come predefinito.
- aspect-ratio - definisce le proporzioni dello schermo (potrebbe non essere disponibile per alcuni modelli di televisori). Valori disponibili: 16:9, 3:2, 4:3, 1,85:1, 2,39:1
In SS IPTV oltre alle tradizionali direttive e gli attributi del formato Extended M3U supporta cose aggiuntive. Usando gli attributi qui descritti, si può personalizzare l'aspetto della playlist sulla schermata principale, manipolando la visualizzazione dei singoli quadrati.
Le linee guida del formato .M3U iniziano sempre con una nuova riga e hanno il primo simbolo cancelletto #, gli attributi da inserire in una stringa (come regola #EXTINF) e sono rappresentati in forma attributo = valore. Il valore dell'attributo deve essere racchiuso tra virgolette doppie.
Ulteriori direttive:
#EXTBG identifica lo sfondo delle piastrelle, correlato a quello descritto nella playlist. Dopo la direttiva può essere indicato il link a un'immagine, o un colore in formato #rrggbb o rgba
#EXTSIZE determina la dimensione delle piastrelle, correlato a quello descritto nella playlist. I valori possibili sono: small, medium, big
#EXTCTRL dopo la direttiva può essere specificato l'url in cui viene effettuata la richiesta cliccando sul titolo corrispondente a quello descritto nell'elemento. La richiesta viene inviata al caricamento dei contenuti. Questa funzione può essere utile ai proprietari di ricevitori satellitari, quando lo si utilizza l'applicazione invierà un ricevitore di comando per la commutazione del canale.
Ulteriori attributi della direttiva #EXTINF:
description – definisce descrizione visualizzato sul titolo con dimensioni medium o big
content-type – consente di specificare un'applicazione tipo quella descritta nei contenuti. Valori possibili: stream, video, playlist. Nella maggior parte dei casi l'applicazione rileva automaticamente il tipo di contenuto e l'utilizzo di questo parametro non è necessario.
Ulteriori attributi della direttiva #EXTM3U directive:
La direttiva #EXTM3U come attributo può contenere attributi: description, size e background. In questo caso i valori impostati per queste caratteristiche si applicano per tutti gli elementi della playlist, se non hanno ridefinito nelle linee guida #EXTINF
Di seguito è riportato un esempio di M3U playlist utilizzando ulteriori direttive e gli attributi, come sarà in app.
#EXTM3U #EXTINF:-1, MTV Dance #EXTSIZE: Big #EXTBG: #11609e http://example.com/stream1 #EXTINF:-1,MTV Hits #EXTSIZE: Medium #EXTBG: #046f55 http://example.com/stream1 #EXTINF:-1,Россия 24 #EXTSIZE: Medium #EXTBG: #046f55 dtv://cabel:11/dvb/8 #EXTINF:-1,Первый канал #EXTSIZE: Medium #EXTBG: #046f55 dtv://cabel:11/dvb/2 #EXTINF:-1, MTV Live HD #EXTSIZE: Small http://example.com/stream3 #EXTINF:-1,MTV Rocks #EXTSIZE: Small http://example.com/stream4
