@danything/arib 2.1.0 → 2.3.0

package/README.md

@@ -1,6 +1,6 @@
 # @danything/arib
 
-日本のデジタル放送 (ISDB-T / ISDB-S / ISDB-C、ARIB 規格) の MPEG-TS を TypeScript で読むライブラリです。
+日本のデジタル放送 (ISDB-T / ISDB-S / ISDB-C、ARIB 規格) の MPEG-TS と、4K の放送の MMT/TLV を TypeScript で読むライブラリです。
 録画サーバ [denpa](https://github.com/danything/denpa) の中で使っているものを切り出しました。
 
 - PSI (`psi`): パケットの切り出し、セクションの組み立て、PAT / PMT / SDT / NIT。衛星はネットワークの全部の TS の NIT と、ほかの TS の SDT もそろえて読む。ケーブルは SDT だけで局をそろえる
@@ -10,8 +10,12 @@
 - 字幕は STD-B24 の字幕文を、字の置き場所まで決めた JSON にする (`b24caption`、形式は `caption-text`)
 - データ放送は DSM-CC のカルーセルからモジュールとファイルを組み立てる (`dsmcc`、`multipart`、`bml`、形式は `bml-protocol`)
 - Hybridcast の AIT を読む (`ait`)。1 つの局だけを抜き出す (`service-filter`)
+- 4K の放送 (MMT/TLV。ARIB STD-B32・B60) の土台として、TLV パケットの切り出し (`tlv`)、IP とヘッダー圧縮した IP から UDP の中身を取り出す処理 (`tlv-ip`)、MMTP のヘッダーとスクランブルの印、信号メッセージの分割と集約 (`mmtp`)
+- 4K の放送の表は、TLV-NIT・PLT・MPT・MH-SDT・MH-TOT (`mmt-si`)。局の一覧と、局ごとの CA_system_id (MPT のアクセス制御記述子) をそろえて読む `TlvServiceReader` もここ (TS の `psi` の `ServiceReader` に当たる)。番組表の MH-EIT は TS と同じ形式の番組にする (`mh-eit`)。1 つの局だけを TLV のまま抜き出す (`mmt-service-filter`)
+- 4K の放送の映像 (HEVC)・音声 (AAC)・字幕 (TTML) のアクセスユニットを、MPT の記述子から付けた PTS・DTS (90 kHz) と一緒に取り出す (`mmt-media`)。音声は LATM を外した AAC のフレームと AudioSpecificConfig、映像は NAL ユニットの並び。字幕の TTML は、TS の字幕と同じ字幕の文字の配置にする (`ttml`)。スクランブルの復号は無い
 - 試験用の TS (PSI・EIT・字幕・カルーセル・映像と音声) を組み立てる (`synth`、`synth-caption`、`synth-av`)
-- ほかのモジュールが使う道具として、バイト列 (`bytes`)、言語の名前 (`language`)、文字の表 (`b24-tables`)、字幕の外字の画像をなめらかにする処理 (`drcs-smooth`)
+- 試験用の TLV (TLV・IP・MMTP・MMT-SI と、MPU の中身・時刻の記述子・LATM) を組み立てる (`synth-mmt`)。本物の HEVC と AAC を時刻を進めて流し続ける (`synth-mmt-av`)
+- ほかのモジュールが使う道具として、バイト列 (`bytes`)、ビット単位の読み取り (`bits`)、言語の名前 (`language`)、文字の表 (`b24-tables`)、字幕の外字の画像をなめらかにする処理 (`drcs-smooth`)
 
 依存するパッケージはありません。
 
@@ -49,6 +53,39 @@ import { decodeAribText } from "@danything/arib/aribtext";
 decodeAribText(bytes); // "🈟ニュース"
 ```
 
+4K の放送は TLV のバイト列を渡します。番組は TS の `EpgReader` と同じ形式 (`EitEvent`) で返ります。
+
+```ts
+import { MmtEpgReader } from "@danything/arib/mh-eit";
+
+const epg = new MmtEpgReader();
+for await (const chunk of tlv) {
+  if (epg.feed(chunk)) {
+    for (const event of epg.takeChanged()) console.log(event.name); // "🈑報道１９３０"
+  }
+}
+```
+
+映像・音声・字幕は、1 局に絞った TLV のバイト列から取り出します。局 (MMT_package_id = service_id) を渡します。
+
+```ts
+import { MmtMediaReader } from "@danything/arib/mmt-media";
+import { ttmlPages } from "@danything/arib/ttml";
+
+const media = new MmtMediaReader(0xa1);
+for await (const chunk of tlv) {
+  for (const unit of media.feed(chunk)) {
+    if (unit.kind === "assets") continue; // 選んだアセットが変わった (受け側を作り直す)
+    if (unit.kind === "video") decodeHevc(unit.nals, unit.pts, unit.dts); // 時刻は 90 kHz
+    if (unit.kind === "audio")
+      decodeAac(unit.frame, unit.config.audioSpecificConfig);
+    if (unit.kind === "caption")
+      for (const { at, page } of ttmlPages(unit.document, unit.pts))
+        draw(at, page);
+  }
+}
+```
+
 ```ts
 import { B24CaptionDecoder } from "@danything/arib/b24caption";
 

package/dist/bits.d.ts

@@ -0,0 +1,25 @@
+/**
+ * ビット単位の読み取り (大きい桁が先)。LATM の AudioMuxElement (`mmt-media.ts`) と、HEVC の SPS のように
+ * バイトの区切りに揃っていない並びを読む。**中身の意味は持たない。**
+ *
+ * 終わりを越えて読むと 0 を返し、`overrun` を立てる。読む側は最後に `overrun` を見て、壊れた並びを捨てる
+ * (1 ビットごとに長さを確かめなくて済む)
+ */
+export declare class BitReader {
+    private readonly data;
+    /** 次に読むビットの位置 (先頭から) */
+    at: number;
+    /** 終わりを越えて読もうとした */
+    overrun: boolean;
+    constructor(data: Uint8Array);
+    /** 残りのビット数 */
+    get left(): number;
+    /** `count` ビット (32 まで) を符号なしの整数で読む */
+    bits(count: number): number;
+    bit(): number;
+    skip(count: number): void;
+    /** 指数ゴロム符号 (符号なし。H.264・HEVC の ue(v)) */
+    ue(): number;
+    /** `from` ビット目から `count` ビットを、先頭に詰めたバイト列にする (端数の後ろは 0) */
+    slice(from: number, count: number): Uint8Array;
+}

package/dist/bits.js

@@ -0,0 +1,66 @@
+/**
+ * ビット単位の読み取り (大きい桁が先)。LATM の AudioMuxElement (`mmt-media.ts`) と、HEVC の SPS のように
+ * バイトの区切りに揃っていない並びを読む。**中身の意味は持たない。**
+ *
+ * 終わりを越えて読むと 0 を返し、`overrun` を立てる。読む側は最後に `overrun` を見て、壊れた並びを捨てる
+ * (1 ビットごとに長さを確かめなくて済む)
+ */
+export class BitReader {
+    data;
+    /** 次に読むビットの位置 (先頭から) */
+    at = 0;
+    /** 終わりを越えて読もうとした */
+    overrun = false;
+    constructor(data) {
+        this.data = data;
+    }
+    /** 残りのビット数 */
+    get left() {
+        return this.data.length * 8 - this.at;
+    }
+    /** `count` ビット (32 まで) を符号なしの整数で読む */
+    bits(count) {
+        let value = 0;
+        for (let i = 0; i < count; i++)
+            value = value * 2 + this.bit();
+        return value;
+    }
+    bit() {
+        const byte = this.data[this.at >> 3];
+        if (byte === undefined) {
+            this.overrun = true;
+            this.at++;
+            return 0;
+        }
+        const value = (byte >> (7 - (this.at & 7))) & 1;
+        this.at++;
+        return value;
+    }
+    skip(count) {
+        this.at += count;
+        if (this.at > this.data.length * 8)
+            this.overrun = true;
+    }
+    /** 指数ゴロム符号 (符号なし。H.264・HEVC の ue(v)) */
+    ue() {
+        let zeros = 0;
+        while (this.bit() === 0) {
+            // 32 を越える 0 は壊れた並び (overrun で止まる)
+            if (++zeros > 32 || this.overrun) {
+                this.overrun = true;
+                return 0;
+            }
+        }
+        return 2 ** zeros - 1 + this.bits(zeros);
+    }
+    /** `from` ビット目から `count` ビットを、先頭に詰めたバイト列にする (端数の後ろは 0) */
+    slice(from, count) {
+        const out = new Uint8Array(Math.ceil(count / 8));
+        const reader = new BitReader(this.data);
+        reader.at = from;
+        for (let i = 0; i < count; i++)
+            if (reader.bit())
+                out[i >> 3] |= 0x80 >> (i & 7);
+        return out;
+    }
+}

package/dist/drcs-smooth.d.ts

@@ -1,7 +1,7 @@
 /**
  * **字幕の外字 (DRCS) の画像を、送る前になめらかにする** ([b24caption.ts](b24caption.ts) が JSON に入れるところで使う)。
  *
- * 放送は置き換え表で字にできない外字を、16〜36 画素の白黒か 4 階調の画像で送ってくる。受け側はそれを字の枠いっぱい
+ * 放送は置き換え表で字にできない外字を、16〜72 画素の白黒か 4 階調・16 階調の画像で送ってくる。受け側はそれを字の枠いっぱい
  * (1920x1080 の全画面で 72 画素ほど) に引き伸ばすので、そのまま渡すと 1 点が 4x4 の階段になり、
  * なめらかに引き伸ばしても階段がぼやけて残る (スピーカー 🔊 の外字など)。
  *

package/dist/drcs-smooth.js

@@ -1,7 +1,7 @@
 /**
  * **字幕の外字 (DRCS) の画像を、送る前になめらかにする** ([b24caption.ts](b24caption.ts) が JSON に入れるところで使う)。
  *
- * 放送は置き換え表で字にできない外字を、16〜36 画素の白黒か 4 階調の画像で送ってくる。受け側はそれを字の枠いっぱい
+ * 放送は置き換え表で字にできない外字を、16〜72 画素の白黒か 4 階調・16 階調の画像で送ってくる。受け側はそれを字の枠いっぱい
  * (1920x1080 の全画面で 72 画素ほど) に引き伸ばすので、そのまま渡すと 1 点が 4x4 の階段になり、
  * なめらかに引き伸ばしても階段がぼやけて残る (スピーカー 🔊 の外字など)。
  *

package/dist/eit.d.ts

@@ -259,6 +259,11 @@ export declare class EpgReader {
     });
     /** 任意の長さのバイト列を渡す。番組が 1 つでも増えたら true */
     feed(chunk: Uint8Array): boolean;
+    /**
+     * 読んだセクションを 1 つ足す。番組が 1 つでも増えたら true。
+     * 4K の放送の番組表 (`mh-eit.ts` の `MmtEpgReader`) は、読み方だけを替えてここに渡す
+     */
+    protected add(section: EitSection): boolean;
     /**
      * 溜めてあるものと混ぜる。**別の表で来るものを消し合わせない。**
      *
@@ -331,10 +336,12 @@ export declare class EpgReader {
  *
  * **中身で比べる。** 書き換われば version が上がるはずだが、上げずに中身だけ替える
  * 送り手を当てにしないよう、番組の番号・時刻・尺・タイトルで比べる。p/f は 1 局ぶん数百バイトが
- * 数秒おきに来るだけなので、毎回読んでも軽い
+ * 数秒おきに来るだけなので、毎回読んでも軽い。
+ *
+ * 4K の放送 (MMT/TLV) の MH-EIT[p/f] は、読み方だけを替えた `mh-eit.ts` の `MmtPresentFollowing` で追う
  */
 export declare class PresentFollowing {
-    private readonly serviceId;
+    protected readonly serviceId: number;
     private readonly sections;
     /** section 0 (いま) と 1 (次) で最後に読んだ番組。来ていなければ null */
     private readonly held;
@@ -351,5 +358,10 @@ export declare class PresentFollowing {
      * 最初に読めたときも true (知らなかったものが分かった)
      */
     feedPacket(packet: Uint8Array): boolean;
+    /**
+     * 読んだ p/f[actual] のセクションを 1 本覚える。**いまか次のどちらかが変わったら true**。
+     * 渡すのは追う局のものだけ (table_id と service_id は呼ぶ側が確かめる)
+     */
+    protected hold(section: EitSection | null): boolean;
 }
 export {};

package/dist/eit.js

@@ -567,30 +567,36 @@ export class EpgReader {
         for (const packet of this.packets.feed(chunk)) {
             for (const raw of this.sections.feed(packet)) {
                 const section = parseEit(raw, this.options);
-                if (section === null)
-                    continue;
-                if (section.tableId >= SCHEDULE_ACTUAL_MIN) {
-                    if (!this.progress.has(section.serviceId))
-                        this.lastNewService = this.now();
-                    const progress = this.progress.get(section.serviceId) ??
-                        new ScheduleProgress(this.now);
-                    progress.add(section);
-                    this.progress.set(section.serviceId, progress);
-                }
-                for (const event of section.events) {
-                    if (section.tableId === TABLE_PF_ACTUAL &&
-                        this.onAir(section, event)) {
-                        this.present.set(event.serviceId, event);
-                    }
-                    if (event.startAt === null || event.duration === null)
-                        continue;
-                    this.merge(event);
+                if (section !== null && this.add(section))
                     added = true;
-                }
             }
         }
         return added;
     }
+    /**
+     * 読んだセクションを 1 つ足す。番組が 1 つでも増えたら true。
+     * 4K の放送の番組表 (`mh-eit.ts` の `MmtEpgReader`) は、読み方だけを替えてここに渡す
+     */
+    add(section) {
+        let added = false;
+        if (section.tableId >= SCHEDULE_ACTUAL_MIN) {
+            if (!this.progress.has(section.serviceId))
+                this.lastNewService = this.now();
+            const progress = this.progress.get(section.serviceId) ?? new ScheduleProgress(this.now);
+            progress.add(section);
+            this.progress.set(section.serviceId, progress);
+        }
+        for (const event of section.events) {
+            if (section.tableId === TABLE_PF_ACTUAL && this.onAir(section, event)) {
+                this.present.set(event.serviceId, event);
+            }
+            if (event.startAt === null || event.duration === null)
+                continue;
+            this.merge(event);
+            added = true;
+        }
+        return added;
+    }
     /**
      * 溜めてあるものと混ぜる。**別の表で来るものを消し合わせない。**
      *
@@ -735,7 +741,9 @@ export class EpgReader {
  *
  * **中身で比べる。** 書き換われば version が上がるはずだが、上げずに中身だけ替える
  * 送り手を当てにしないよう、番組の番号・時刻・尺・タイトルで比べる。p/f は 1 局ぶん数百バイトが
- * 数秒おきに来るだけなので、毎回読んでも軽い
+ * 数秒おきに来るだけなので、毎回読んでも軽い。
+ *
+ * 4K の放送 (MMT/TLV) の MH-EIT[p/f] は、読み方だけを替えた `mh-eit.ts` の `MmtPresentFollowing` で追う
  */
 export class PresentFollowing {
     serviceId;
@@ -768,20 +776,27 @@ export class PresentFollowing {
                 continue;
             if (u16(raw, 3) !== this.serviceId)
                 continue;
-            const section = parseEit(raw);
-            if (section === null || section.sectionNumber > 1)
-                continue;
-            const slot = section.sectionNumber;
-            const event = section.events[0] ?? null;
-            const mark = event === null ? "" : markOf(event);
-            if (this.marks[slot] === mark)
-                continue;
-            this.marks[slot] = mark;
-            this.held[slot] = event;
-            changed = true;
+            if (this.hold(parseEit(raw)))
+                changed = true;
         }
         return changed;
     }
+    /**
+     * 読んだ p/f[actual] のセクションを 1 本覚える。**いまか次のどちらかが変わったら true**。
+     * 渡すのは追う局のものだけ (table_id と service_id は呼ぶ側が確かめる)
+     */
+    hold(section) {
+        if (section === null || section.sectionNumber > 1)
+            return false;
+        const slot = section.sectionNumber;
+        const event = section.events[0] ?? null;
+        const mark = event === null ? "" : markOf(event);
+        if (this.marks[slot] === mark)
+            return false;
+        this.marks[slot] = mark;
+        this.held[slot] = event;
+        return true;
+    }
 }
 /** 変わったかどうかを見る中身。**番号・時刻・尺・タイトルだけ** (番組表に入れて画面に出るもの) */
 function markOf(event) {

package/dist/mh-eit.d.ts

@@ -0,0 +1,43 @@
+/**
+ * 4K の放送 (MMT/TLV) の番組表 MH-EIT (ARIB STD-B60) を、TS の番組表と同じ `EitEvent` に読む。
+ *
+ * 並びは TS の EIT と同じで、違うのは次の所 (実機のケーブルの BS4K で確かめた)。
+ *
+ * - TS の transport_stream_id の位置に tlv_stream_id が入る。`EitEvent.transportStreamId` にはそれを入れる
+ * - table_id は p/f が 0x8B、予定の基本が 0x8C から、詳細が 0x94 から。**TS の番号 (0x4E・0x50・0x58) に直して返す**
+ *   ので、揃ったかの数え方 (`ScheduleProgress`) と混ぜ方 (`EpgReader`) をそのまま使える
+ * - 記述子のタグが 2 バイトで (`mmt-si.ts` の `mmtDescriptors`)、文字は UTF-8。番組名の「🈑」なども Unicode の文字で来る
+ *
+ * 番組の記述子で読むのは、MH-短形式イベント (0xF001)・MH-拡張形式イベント (0xF002)・MH-コンテント (0x8012)・
+ * 映像コンポーネント (0x8010)・MH-音声コンポーネント (0x8014)・コンテンツコピー制御 (0x8038)。
+ * シリーズの記述子は来ていないので読まない (`series` を付けない。「この表は言っていない」)
+ */
+import { type EitSection, EpgReader, PresentFollowing } from "./eit.js";
+/**
+ * MH-EIT のセクションを 1 本読む。table_id は TS の番号に直す。番組表でなければ null。
+ * CRC は読む前に確かめてある (`MmtTableStream`) ので、長さの合わない番組の手前まで返す
+ */
+export declare function parseMhEit(section: Uint8Array): EitSection | null;
+/**
+ * 流れてくる TLV のバイト列から番組表を溜める。**読み方のほかは TS の `EpgReader` と同じ**
+ * (揃ったかの数え方、別の表で来るものの混ぜ方、p/f の「いま」)。
+ *
+ * MH-EIT は自分の TLV のストリームの局のぶんだけが来る (実機のケーブルの BS4K で確かめた)。
+ * TS の `other` (ほかの TS の局の番組表) に当たるものは無い
+ */
+export declare class MmtEpgReader extends EpgReader {
+    private readonly tables;
+    /** @param now いまの時刻。過ぎた時間帯の予定を待たないのに使う (`ScheduleProgress`) */
+    constructor(now?: () => number);
+    /** 任意の長さの TLV のバイト列を渡す。番組が 1 つでも増えたら true */
+    feed(chunk: Uint8Array): boolean;
+}
+/**
+ * **1 局の「いま」と「次」(MH-EIT[p/f]) を追う。** TS の `PresentFollowing` を 4K の放送 (MMT/TLV) で使えるようにしたもので、
+ * 違うのは読み方だけ (覚え方と、変わったかの比べ方は同じ)。ライブで番組の切り替わりを知るのに使う
+ */
+export declare class MmtPresentFollowing extends PresentFollowing {
+    private readonly tables;
+    /** 任意の長さの TLV のバイト列を渡す。**いまか次のどちらかが変わったら true** (最初に読めたときも true) */
+    feed(chunk: Uint8Array): boolean;
+}

package/dist/mh-eit.js

@@ -0,0 +1,275 @@
+/**
+ * 4K の放送 (MMT/TLV) の番組表 MH-EIT (ARIB STD-B60) を、TS の番組表と同じ `EitEvent` に読む。
+ *
+ * 並びは TS の EIT と同じで、違うのは次の所 (実機のケーブルの BS4K で確かめた)。
+ *
+ * - TS の transport_stream_id の位置に tlv_stream_id が入る。`EitEvent.transportStreamId` にはそれを入れる
+ * - table_id は p/f が 0x8B、予定の基本が 0x8C から、詳細が 0x94 から。**TS の番号 (0x4E・0x50・0x58) に直して返す**
+ *   ので、揃ったかの数え方 (`ScheduleProgress`) と混ぜ方 (`EpgReader`) をそのまま使える
+ * - 記述子のタグが 2 バイトで (`mmt-si.ts` の `mmtDescriptors`)、文字は UTF-8。番組名の「🈑」なども Unicode の文字で来る
+ *
+ * 番組の記述子で読むのは、MH-短形式イベント (0xF001)・MH-拡張形式イベント (0xF002)・MH-コンテント (0x8012)・
+ * 映像コンポーネント (0x8010)・MH-音声コンポーネント (0x8014)・コンテンツコピー制御 (0x8038)。
+ * シリーズの記述子は来ていないので読まない (`series` を付けない。「この表は言っていない」)
+ */
+import { ascii, joinBytes, u16 } from "./bytes.js";
+import { EpgReader, parseBcdDuration, parseMjdTime, PresentFollowing, } from "./eit.js";
+import { mmtDescriptors, MmtTableStream, mmtText } from "./mmt-si.js";
+import { isCopyNever } from "./psi.js";
+const MH_PF_ACTUAL = 0x8b;
+const MH_SCHEDULE_MIN = 0x8c;
+const MH_SCHEDULE_MAX = 0x9b;
+/** TS の EIT の番号 (p/f 0x4E、予定 0x50〜0x5F) */
+const TS_PF_ACTUAL = 0x4e;
+const TS_SCHEDULE_MIN = 0x50;
+/** TS の詳細の表の始まり。これより後ろの表は基本の記述子 (コピー制御など) を載せない */
+const TS_SCHEDULE_EXTENDED = 0x58;
+const DESC_SHORT_EVENT = 0xf001;
+const DESC_EXTENDED_EVENT = 0xf002;
+const DESC_CONTENT = 0x8012;
+const DESC_VIDEO_COMPONENT = 0x8010;
+const DESC_AUDIO_COMPONENT = 0x8014;
+const DESC_CONTENT_COPY_CONTROL = 0x8038;
+/** MH-EIT の table_id を TS の EIT の番号に。番組表でなければ null */
+function tsTableId(tableId) {
+    if (tableId === MH_PF_ACTUAL)
+        return TS_PF_ACTUAL;
+    if (tableId >= MH_SCHEDULE_MIN && tableId <= MH_SCHEDULE_MAX)
+        return TS_SCHEDULE_MIN + (tableId - MH_SCHEDULE_MIN);
+    return null;
+}
+/** video_resolution (4 ビット) の走査線の数。0 は未定義 */
+const LINES = {
+    1: 180,
+    2: 240,
+    3: 480,
+    4: 720,
+    5: 1080,
+    6: 2160,
+    7: 4320,
+};
+/** sampling_rate (3 ビット)。TS の音声コンポーネント記述子と同じ符号 */
+const SAMPLING_RATE = {
+    1: 16000,
+    2: 22050,
+    3: 24000,
+    5: 32000,
+    6: 44100,
+    7: 48000,
+};
+const lang = (data, at) => ascii(data, at, 3).toLowerCase();
+/**
+ * 番組の記述子を読んで埋める。**拡張形式イベントは項目ごとに、バイトのまま繋いでから文字にする。**
+ * UTF-8 の 1 文字が記述子の切れ目をまたぐことがあり、部分ごとに文字にすると、またいだ字が U+FFFD になる。
+ * 見出しが空の項目は直前の項目の続き (TS の `eit.ts` と同じ決まり)
+ */
+function readDescriptors(event, body) {
+    const pending = new Map();
+    let lastHeading = "";
+    for (const [tag, data] of mmtDescriptors(body)) {
+        switch (tag) {
+            case DESC_SHORT_EVENT: {
+                // 言語 (3)・番組名の長さ (1)・番組名・説明の長さ (2)・説明
+                if (data.length < 4)
+                    break;
+                const textAt = 4 + data[3];
+                event.name = mmtText(data.subarray(4, textAt));
+                if (textAt + 2 > data.length)
+                    break;
+                event.description = mmtText(data.subarray(textAt + 2, textAt + 2 + u16(data, textAt)));
+                break;
+            }
+            case DESC_EXTENDED_EVENT: {
+                // 番号 (1)・言語 (3)・項目の長さ (2)。項目は見出し (長さ 1 バイト) と本文 (長さ 2 バイト) の組
+                if (data.length < 6)
+                    break;
+                const itemsEnd = Math.min(data.length, 6 + u16(data, 4));
+                let at = 6;
+                while (at + 1 <= itemsEnd) {
+                    const headingEnd = at + 1 + data[at];
+                    if (headingEnd + 2 > itemsEnd)
+                        break;
+                    const heading = mmtText(data.subarray(at + 1, headingEnd));
+                    const textEnd = headingEnd + 2 + u16(data, headingEnd);
+                    const text = data.subarray(headingEnd + 2, textEnd);
+                    at = textEnd;
+                    if (heading === "") {
+                        if (lastHeading === "")
+                            continue;
+                        pending.get(lastHeading).at(-1).push(text);
+                        continue;
+                    }
+                    const items = pending.get(heading);
+                    if (items === undefined)
+                        pending.set(heading, [[text]]);
+                    else
+                        items.push([text]);
+                    lastHeading = heading;
+                }
+                break;
+            }
+            case DESC_CONTENT: {
+                for (let at = 0; at + 2 <= data.length; at += 2)
+                    event.genres.push({ lv1: data[at] >> 4, lv2: data[at] & 0x0f });
+                break;
+            }
+            case DESC_VIDEO_COMPONENT: {
+                // video_resolution (4)・アスペクト比 (4)、走査 (1: プログレッシブ)・予約 (2)・コマの速さ (5)
+                if (data.length < 2)
+                    break;
+                const lines = LINES[data[0] >> 4];
+                const progressive = (data[1] & 0x80) !== 0;
+                // 符号化の方式はこの記述子に無い (MPT のアセットの型で分かる)
+                event.video = {
+                    type: null,
+                    resolution: lines === undefined ? null : `${lines}${progressive ? "p" : "i"}`,
+                };
+                break;
+            }
+            /*
+             * MH-音声コンポーネント記述子。TS の音声コンポーネント記述子と比べて、component_tag が 2 バイトになっている。
+             *
+             *     [0] reserved(4) stream_content(4)
+             *     [1] component_type
+             *     [2..3] component_tag
+             *     [4] stream_type
+             *     [5] simulcast_group_tag
+             *     [6] 多言語(1) 主音声(1) 品質(2) 標本化周波数(3) reserved(1)
+             *     [7..9]   ISO 639-2
+             *     [10..12] ISO 639-2 (多言語のときだけ)
+             *     [残り]   text_char (UTF-8)
+             */
+            case DESC_AUDIO_COMPONENT: {
+                if (data.length < 10)
+                    break;
+                const flags = data[6];
+                const multiLingual = (flags & 0x80) !== 0;
+                const langs = [lang(data, 7)];
+                if (multiLingual)
+                    langs.push(lang(data, 10));
+                const text = mmtText(data.subarray(multiLingual ? 13 : 10)).trim();
+                const samplingRate = SAMPLING_RATE[(flags >> 1) & 0x07];
+                event.audios.push({
+                    componentType: data[1],
+                    langs,
+                    ...(samplingRate === undefined ? {} : { samplingRate }),
+                    ...(text === "" ? {} : { text }),
+                    main: (flags & 0x40) !== 0,
+                });
+                break;
+            }
+            case DESC_CONTENT_COPY_CONTROL: {
+                // 先頭 2 ビットが digital_recording_control_data で、TS のデジタルコピー制御記述子と同じ符号
+                event.copyNever = isCopyNever(data);
+                break;
+            }
+            default:
+                break;
+        }
+    }
+    for (const [heading, items] of pending)
+        event.extended[heading] = items
+            .map((parts) => mmtText(joinBytes(parts)))
+            .join("");
+}
+/**
+ * MH-EIT のセクションを 1 本読む。table_id は TS の番号に直す。番組表でなければ null。
+ * CRC は読む前に確かめてある (`MmtTableStream`) ので、長さの合わない番組の手前まで返す
+ */
+export function parseMhEit(section) {
+    if (section.length < 18)
+        return null;
+    const tableId = tsTableId(section[0]);
+    if (tableId === null)
+        return null;
+    const extended = tableId >= TS_SCHEDULE_EXTENDED;
+    const lastTableId = tsTableId(section[13]) ?? tableId;
+    const result = {
+        tableId,
+        serviceId: u16(section, 3),
+        version: (section[5] >> 1) & 0x1f,
+        sectionNumber: section[6],
+        lastSectionNumber: section[7],
+        transportStreamId: u16(section, 8),
+        originalNetworkId: u16(section, 10),
+        segmentLastSectionNumber: section[12],
+        lastTableId,
+        events: [],
+    };
+    let at = 14;
+    const end = section.length - 4;
+    while (at + 12 <= end) {
+        const descriptorsLength = u16(section, at + 10) & 0x0fff;
+        const body = section.subarray(at + 12, at + 12 + descriptorsLength);
+        const event = {
+            serviceId: result.serviceId,
+            transportStreamId: result.transportStreamId,
+            originalNetworkId: result.originalNetworkId,
+            eventId: u16(section, at),
+            startAt: parseMjdTime(section, at + 2),
+            duration: parseBcdDuration(section, at + 7),
+            runningStatus: (section[at + 10] >> 5) & 0x07,
+            isFree: (section[at + 10] & 0x10) === 0,
+            name: "",
+            description: "",
+            extended: {},
+            genres: [],
+            audios: [],
+            video: null,
+            copyNever: extended ? null : false,
+            // B-CAS の契約確認は使わない
+            ...(extended ? {} : { contractVerification: null }),
+        };
+        at += 12 + descriptorsLength;
+        if (body.length < descriptorsLength)
+            break;
+        readDescriptors(event, body);
+        result.events.push(event);
+    }
+    return result;
+}
+/**
+ * 流れてくる TLV のバイト列から番組表を溜める。**読み方のほかは TS の `EpgReader` と同じ**
+ * (揃ったかの数え方、別の表で来るものの混ぜ方、p/f の「いま」)。
+ *
+ * MH-EIT は自分の TLV のストリームの局のぶんだけが来る (実機のケーブルの BS4K で確かめた)。
+ * TS の `other` (ほかの TS の局の番組表) に当たるものは無い
+ */
+export class MmtEpgReader extends EpgReader {
+    tables = new MmtTableStream();
+    /** @param now いまの時刻。過ぎた時間帯の予定を待たないのに使う (`ScheduleProgress`) */
+    constructor(now = Date.now) {
+        super(now);
+    }
+    /** 任意の長さの TLV のバイト列を渡す。番組が 1 つでも増えたら true */
+    feed(chunk) {
+        let added = false;
+        for (const { table } of this.tables.feed(chunk)) {
+            const section = parseMhEit(table);
+            if (section !== null && this.add(section))
+                added = true;
+        }
+        return added;
+    }
+}
+/**
+ * **1 局の「いま」と「次」(MH-EIT[p/f]) を追う。** TS の `PresentFollowing` を 4K の放送 (MMT/TLV) で使えるようにしたもので、
+ * 違うのは読み方だけ (覚え方と、変わったかの比べ方は同じ)。ライブで番組の切り替わりを知るのに使う
+ */
+export class MmtPresentFollowing extends PresentFollowing {
+    tables = new MmtTableStream();
+    /** 任意の長さの TLV のバイト列を渡す。**いまか次のどちらかが変わったら true** (最初に読めたときも true) */
+    feed(chunk) {
+        let changed = false;
+        for (const { table } of this.tables.feed(chunk)) {
+            // 予定 (0x8C〜) は読まずに捨てる。同じ並びに流れてくる
+            if (table[0] !== MH_PF_ACTUAL || table.length < 18)
+                continue;
+            if (u16(table, 3) !== this.serviceId)
+                continue;
+            if (this.hold(parseMhEit(table)))
+                changed = true;
+        }
+        return changed;
+    }
+}