Mayk IP TV

技術リファレンス

M3Uプレイリストフォーマット仕様

IPTV向けM3Uプレイリスト形式の完全仕様。ティア1およびティア2のタグ仕様、チャンネル解析ルールを詳しく学び、プレイリストを対話型チェッカーで検証。

Mayk IP TVにおけるM3Uフォーマットの概要

M3Uプレイリスト形式はIPTVチャンネル配信における国際標準規格です。Mayk IP TVは従来のM3Uファイルおよび高度なメタデータを備えた最新のM3U8ファイルをサポートします。

プレイリストの構造と構文仕様

有効なM3Uファイルは必ず先頭行の #EXTM3U 宣言で始まり、その後に #EXTINF メタデータ行と直接ストリーミングURLが対になって続きます。

VODおよびテレビシリーズの分類規則

配信コンテンツは、S01 E02 のようなシーズンおよびエピソード表記に基づいて、生中継、映画、またはドラマエピソードに自動分類されます。

安定したパースのための推奨事項

電子番組表(EPG)の確実な連動のため、常にUTF-8エンコードを使用し、有効なHTTP/HTTPS配信リンクと一意の tvg-id 値を設定してください。

ティア1: 標準 #EXTINF タグ

フィールド / タグ階層タイプサンプル値説明
#EXTM3U標準 (ティア1) · 必須Directive (Header)#EXTM3Uファイルを拡張M3Uプレイリストとして定義する必須のヘッダー行。
#EXTINF標準 (ティア1) · 必須Directive (Metadata)#EXTINF:-1 tvg-id="trt1" tvg-name="TRT 1",TRT 1 HD配信時間およびメタデータ属性を指定するトラック情報ディレクティブ。
tvg-id標準 (ティア1) · 任意Stringtrt1.trチャンネルをXMLTV EPG番組表データの特定項目と紐付ける一意の識別子。
tvg-name標準 (ティア1) · 任意StringTRT 1 HD電子番組表(EPG)内に登録されている公式チャンネル名称。
tvg-logo標準 (ティア1) · 任意URL (http/https)https://stream.example.com:8080/images/trt1.pngチャンネルロゴ画像への直接リンクURL(HTTPS経由のPNGまたはSVGを推奨)。
group-title標準 (ティア1) · 任意StringNationalプレーヤー画面のメニュー内でチャンネルを分類・表示するためのカテゴリ名。
#EXTGRP:標準 (ティア1) · 任意Directive#EXTGRP:NationalEXTINF行の直後に配置される代替カテゴリグループ指定ディレクティブ。

ティア2: Mayk IP TV 拡張タグ

フィールド / タグ階層タイプサンプル値説明
media-type拡張 (ティア2) · 任意Enum ("live" | "movie" | "series")media-type="series"明示的なメディア種別の上書き指定:'live'、'movie'、または 'series'。
series-id拡張 (ティア2) · 任意String / Integerseries-id="show-42"複数のエピソード配信をひとまとめにグループ化する一意のシリーズ識別子。
series-name拡張 (ティア2) · 任意Stringseries-name="Example Series"シーズンや各話トラックを集約するためのテレビ番組シリーズの正式名称。
season拡張 (ティア2) · 任意Integerseason="1"テレビシリーズ各話が属するシーズン番号の数値表記(整数)。
episode拡張 (ティア2) · 任意Integerepisode="4"指定されたシーズン内におけるエピソード話数番号(整数)。
is_adult拡張 (ティア2) · 任意Integer ("0" | "1")is_adult="1"ペアレンタルロック識別フラグ:'1' は成人向けまたは年齢制限コンテンツ。
age_rating拡張 (ティア2) · 任意Stringage_rating="18+"ペアレンタルコントロール用フィルターの最低対象年齢バッジ(例: '18+')。

コンテンツ分類規則

種別#サンプル値
ライブTV#3http(s)://... | media-type="live"
映画 (VOD)#2/movie/... | media-type="movie"
シリーズエピソード#1/series/... + S01E01 / S01.E01 | media-type="series"

サンプルテンプレート

ライブTV (M3U / #EXTINF)
#EXTM3U
#EXTINF:-1 tvg-id="trt1.tr" tvg-name="TRT 1 HD" tvg-logo="https://stream.example.com:8080/images/trt1.png" group-title="Ulusal",TRT 1 HD
https://stream.example.com:8080/live/demo_user/demo_pass/101.m3u8
#EXTINF:-1 tvg-id="atv.tr" tvg-name="ATV HD" tvg-logo="https://stream.example.com:8080/images/atv.png" group-title="Ulusal",ATV HD
https://stream.example.com:8080/live/demo_user/demo_pass/102.m3u8
映画 (VOD) & シリーズエピソード (M3U / #EXTINF)
#EXTM3U
#EXTINF:-1 tvg-logo="https://stream.example.com:8080/images/movie202.png" group-title="Sinema",Example Movie (2026)
https://stream.example.com:8080/movie/demo_user/demo_pass/202.mp4
#EXTINF:-1 group-title="Dizi",Example Series - S01E01 - Pilot
https://stream.example.com:8080/series/demo_user/demo_pass/30301.mp4
#EXTINF:-1 media-type="series" series-name="Custom Show" season="1" episode="2" group-title="Dizi",Custom Show - S01E02
https://stream.example.com:8080/series/demo_user/demo_pass/30302.mp4

対話型フォーマットチェッカー

Mayk IP TVとの互換性を確認するために、以下にM3UスニペットまたはXtream JSON応答を貼り付けてください。

M3U互換性チェックリスト

  • ファイルの先頭行が完全に #EXTM3U であることを確認してください。
  • すべての継続的なライブテレビ放送の再生時間には -1 を指定してください。
  • XMLTVデータソースと完全に一致する正しい tvg-id 値を割り当ててください。
  • group-title 属性を活用してチャンネルを整理されたグループに分類してください。
  • ファイルはBOM(バイト順マーク)なしの純粋なUTF-8形式で保存してください。