Hornitzaile batek "Xtream Codes sarbidea" bidaltzen dizunean — zerbitzari bat, erabiltzaile-izen bat eta pasahitz bat — ez dizu ezer berririk ematen formatu aldetik. Xtream sarbide bat M3U URL batek dagoeneko daukan guztia idazteko modu txukun bat besterik ez da.
Gida honek bi norabideetako bihurketa azaltzen du, zerekin ibili behar den kontuz, eta nola egin zure egiaztagiriak edozein ezezagunek irakur ditzakeen leku batean idatzi gabe. Webgune honetako Xtream ↔ M3U URL bihurtzaileak bihurketa zure nabigatzailean bertan egiten du erabat — ez dago zerbitzariko endpoint-ik orri horren atzean.
M3U URLa txantiloi finko bat da; Xtream sarbide bat txantiloi horretan sartutako hiru egiaztagiriak besterik ez dira.
Zergatik den beharrezkoa bihurketa
Hornitzaile berak ia beti onartzen ditu bi formak, baina instalatzen duzun playerrak bat bakarrik eskatuko dizu. Aplikazioek desadostasunak dituzte puntu zehatz batzuetan:
- Xtream onartzen duten playerrek (IPTV aplikazio moderno gehienak, Klipa barne) hiru egiaztagiriak nahiago dituzte. Hori erabiltzen dute zuzeneko kanalen zerrenda, VOD liburutegia, telesailen katalogoa eta EPGa dokumentu banandu gisa jasotzeko — kategorizazio hobea, eguneratze dinamikoa, M3U esportazioak adierazi ezin dituen eskaerapeko atalak.
- M3U soilik onartzen duten player zaharrek (VLC, Smart TV aplikazio oinarrizkoak, IPTV kutxa dedikatuak) URL bakar bat hartzen dute. Ez dute Xtream API endpoint-en berri; playlist fitxategi lau bat deskargatzen dute eta bertan dauden stream-ak erreproduzitzen dituzte.
Zure hornitzaileak bat eman badizu eta playerrak bestea nahi badu, bihurketa 30 segundoko eragiketa da. Ez diozu hornitzaileari "beste formatua" eskatu behar — jada biak ematen ari zaizkizu, forma bakarrean baizik.
Formula: Xtream-etik M3U-ra
Xtream hornitzaile bakoitzak URL txantiloi bera erabiltzen du. Behin ezagutzen duzunean, eskuz eraiki dezakezu M3U URLa egiaztagirietatik abiatuta:
[ZERBITZARIA]/get.php?username=[ERABILTZAILE_IZENA]&password=[PASAHITZA]&type=m3u_plus&output=mpegts
Hiru adibide zehatz, server: http://server.example:8080, username: ABC, password: XYZ egiaztagiriak izanda:
- Live + VOD + Series (M3U Plus):
http://server.example:8080/get.php?username=ABC&password=XYZ&type=m3u_plus&output=mpegts - Zuzeneko kanalak soilik:
http://server.example:8080/get.php?username=ABC&password=XYZ&type=m3u&output=mpegts - EPG (XMLTV gida):
http://server.example:8080/xmltv.php?username=ABC&password=XYZ
Kontuan hartzeko gakoak:
get.phpplaylist-aren endpoint-a da. Betiget.phpdeitzen da — ez dago hornitzailearen araberako izen-konbentziorik hemen.type=m3u_pluskanal-logoak eta talde-izenburu barne hartzen dituen M3U formatu hedatua eskatzen du.type=m3uhutsak ere funtzionatzen du baina playlist meheago bat sortzen du; ia betim3u_plusnahi duzu.output=mpegts-k MPEG-TS gordin gisa erreproduzitzen diren stream-ak eskatzen ditu. Beste aukera arruntaoutput=hlsda, HLS (.m3u8) URLak sortzen dituena — erabilgarria nabigatzaileentzat eta Apple gailu batzuentzat, ez hain unibertsalki onartua telebista kutxetan. Zure playerra zorrotza bada,outputaldatzea da saiatu beharreko lehen gauza.xmltv.phpEPG endpoint-a da. Egiaztagiri berak, dokumentu bereizia. Player gehienek URL hau beste eremu batean hartzen dute ("EPG URL" edo "XMLTV URL").player_api.phpJSON API-a da. "Xtream natiboki hitz egiten" duten playerrek hau erabiltzen dute zuzeneko/VOD/telesailen zuhaitzak eta kanal-logoak eskuratzeko.
Formula: M3U-tik Xtream-era
Goiko formularen itxura duen M3U URL bat izanda, hiru Xtream eremuak zuzenean atera ditzakezu:
http://server.example:8080/get.php?username=ABC&password=XYZ&type=m3u_plus
- Zerbitzaria (Server) host-aren osteko lehen barrarekin hasten denaren aurreko guztia da:
http://server.example:8080. Kendu/get.phpeta atzetik datorren guztia. - Erabiltzaile-izena (Username)
usernamekontsulta-parametroaren balioa da. - Pasahitza (Password)
passwordkontsulta-parametroaren balioa da.
Kontsulta-parametroren bat falta bada, URLa ez dago Xtream formatu estandarrean. Hornitzaile batzuek bere baitan egiaztagiririk ez duten M3U URL arruntak bidaltzen dituzte — normalean playlist estatikoak edo token bidezkoak non URLa bera den sekretua. Horietatik ez dago ezer ateratzeko; URLa dagoen bezala erabiltzen duzu M3U bateragarria den edozein playerretan.
Kasu bereziak eta oztopoak
Karaktere bereziak pasahitzetan
Zure pasahitzak &, =, +, #, % edo / bezalako karaktereak baditu, URL barruan ehunekoen bidez kodetu behar dira. Pasahitz baten erdian & literal batek URL azterketa hausten du — playerrak bere atzetik datorren guztia beste kontsulta-parametro gisa tratatuko luke.
Hornitzaileen kontrol panel gehienek zure ordez egiten dute hau. URLa eskuz eraikitzen ari bazara eta zure pasahitzak gauza arrarorik badu, pasatu pasahitza edozein "URL encode" tresnatik lehenik. Edo erabat saltatu urratsa eta utzi nabigatzaileko bihurtzaileari zure ordez egiten.
Atakak eta HTTPS
Xtream hornitzaileek oso gutxitan funtzionatzen dute lehenetsitako 80 edo 443 ataketan. Ohikoak 8080, 25461, 8000 edo ataka altu ausazko bat dira. Ataka zerbitzariaren URLaren zati da, ez aukerakoa. http://server.example/get.php?… atakarik gabe ikusten baduzu, edo 80 ataka erabiltzen ari da (arraroa) edo hornitzaileak alderantzizko proxy bat du aurrean (arraroa ere bai). Gehienetan ataka falta da norbaitek URLa eskuz kopiatu duelako eta baztertu duelako.
Xtream hornitzaile gehienek HTTP ematen dute, ez HTTPS. https:// formak askotan ziurtagiri akats bat edo 404 bat itzultzen du zerbitzariak ez duelako TLS lotzen. https:// duen zerbitzari-URL bat eman badizute eta ez badu funtzionatzen, probatu http:// hutsarekin. Trukean zure pasahitza enkriptatu gabe bidaiatzen duela da; hori zoritxarrez arau bihurtu da IPTV hornitzaileentzat.
M3U URLaren bide pertsonalizatua
Hornitzaile batzuek euren bideraketa pertsonalizatzen dute — /get.php ordez, /playlist.m3u, /m3u.php, edo /index.php?type=m3u ere ikusiko duzu. URL horien barruko egiaztagiriak Xtream API-ak espero duenarekin bat datoz oraindik ere, beraz, bihurtzaileak behar bezala aterako ditu, baina hornitzaileak erabiltzen duen playlist URLa ez da estandarra. Zure M3U URLa eraikitzen baduzu /get.php bide estandarra erabiliz, baliteke hornitzaileak arbuiatzea. Kasu hauetan, mantendu hornitzaileak eman dizun jatorrizko URLa — ez saiatu "konpontzen".
Zuriuneak egiaztagirien amaieran
Mezu elektroniko batetik edo foro bateko argitalpen batetik itsasteak maiz zuriune, lerro-jauzi edo espazio zuri ikusezin bat arrastatzen du erabiltzaile-izenaren amaierara. Xtream API-ak ABC eta ABC bi erabiltzaile-izen ezberdin gisa tratatzen ditu; pasahitz oker baten berdin-berdina den autentifikazio-akats baten erantzuna jasoko duzu. Bihurtzaileak zuriuneak automatikoki kentzen ditu erabiltzaile-izenetik eta abisatu egiten dizu hala egin behar izan duenean. URLa eskuz eraikitzen ari bazara, itsatsi eremu bakoitza testu-editore soil batean lehenik eta begiratu amaiera ikusmenez.
Bihurketa modu seguruan egitea
Webgune honetako bihurtzailea eraikita dago zure egiaztagiriei buruzko sarbide-erregistrorik izan ez dezan, atzean ez baitago zerbitzariko endpoint-ik. Bihurketa guztiz exekutatzen da zure nabigatzailean JavaScript gisa. Egiaztagiriak DOM sarrera elementuetan bizi dira orria itxi arte; ez daude URL barran, ez daude localStorage barruan, eta ez dira inora bidaltzen. Bihurketa batean zehar nabigatzailearen sare fitxa (network tab) irekitzen baduzu, zehazki zero irteerako eskaera ikusiko dituzu egiaztagiriak daramatzatenak.
Hori da IPTV egiaztagiriak eskatzen dituen edozein tresnatik espero beharko zenukeen estandarra. Bihurtzaile UI batek "bihurtu" sakatzen duzunean sareko eskaera bat bidaltzen badu, definizioz, zure egiaztagiriak norabait transmititu ditu.
Emaitza egiaztatzea
Arrakastaz eraikitako URL batek ez du esan nahi funtzionatzen duen URL bat denik. Bihurketa norabide bietan transformazio determinista bat da — transformazio gisa zuzenak dira, baina ez dizute esaten egiaztagiriak baliozkoak diren, harpidetza indarrean dagoen edo zerbitzaria eskuragarri dagoen.
- M3U URLentzat, itsatsi emaitza M3U playlist testatzailean. Playlist-a eskuratu, aztertu eta lehen 100 stream-ak probatzen ditu. Berde dagoen edozein gauzak URLa ona dela esan nahi du; gorri dagoen edozein gauzak hutsegite modu zehatza esaten dizu (HTML erantzuna, 404, stream hilak).
- Xtream egiaztagirientzat, itsatsi hirukotea Xtream egiaztagirien egiaztatzailean. API-ri deitzen dio zerbitzari aldetik, eta autentifikazio egoera, iraungipena, konexio mugak eta kanal kopuruak itzultzen ditu. "Pasahitz okerra", "harpidetza iraungita" eta "zerbitzaria eskuraezin" desberdintzen ditu.
Hauetako bat exekutatzeak player bat instalatzen kezkatu aurretik, arazketa-hogei minutu inguru aurrezten dizkizu egiaztagirietan bertan zerbait gaizki dagoenean.
M3U URLak egiaztagiririk ez duenean
Aurkituko dituzun M3U URLen proportzio txiki bat ez da batere Xtream. Zerbitzari estatiko batean ostatatutako playlist lauak dira, edo URLaren bidean bertan (eta ez kontsulta-katean) sekretua txertatuta duten token bidezko URLak:
https://server.example/playlists/9c1f4a8b3e/stream.m3u8
Ez dago ezer ateratzeko — URLa bera da egiaztagiria. Hauek M3U soilik onartzen duten playerretan funtzionatzen dute dauden bezala. Ez dute Xtream-en baliokide den irudikapenik Xtream Codes panelak ez dituelako sortzen; beste (zaharragoa den) IPTV pila batetik datoz. Zure hornitzaileak hau bakarrik eman badizu eta zure playerrak Xtream egiaztagiriak eskatzen tematzen bada, ez dute Xtream sarbiderik zuri emateko. Galdetu hornitzaileari, edo aukeratu M3U URLak onartzen dituen player bat.
Klipak bi formak onartzen ditu liburutegi berean, bata bestearen ondoan. Hornitzaile beraren M3U URL bat eta Xtream sarbide bat gehi ditzakezu iturri bereizi gisa; aplikazioak osasuntsuena erabiltzen du. M3U esportazioak egunen batean HTML itzultzen hasten bada, Xtream API deiak zure kanalen zerrenda bizirik mantentzen du hurrengo eguneraketara arte, eta alderantziz.
Hori da "zein formatu erabili behar nuke" galderaren erantzun erraza — biak. Bakar bat aukeratzen baduzu, Xtream vs M3U konparazioak argitzen du zein erabili lehenetsi bezala egoera bakoitzean.