@danything/arib 2.0.0 → 2.2.0

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;
+    }
+}

package/dist/mmt-media.d.ts

@@ -0,0 +1,168 @@
+/**
+ * 4K の放送 (MMT/TLV) の映像・音声・字幕を取り出す (ISO/IEC 23008-1、ARIB STD-B60)。TS の `pes.ts` に当たる。
+ *
+ * MMT では、映像・音声・字幕は MPU (頭出しできる所から次の頭出しできる所まで) に分けて送られる。
+ * MPU の中身はアクセスユニット (映像の 1 コマ、音声の 1 フレーム) の並びで、データユニットを
+ * MMTP のパケットに分割したり、小さいものを 1 つに集約したりして運ぶ (`mmtp.ts` の `parseMpu`)。
+ *
+ * **時刻はパケットには無く、MPT の記述子にある。** MPU タイムスタンプ記述子が MPU の最初の提示時刻を、
+ * MPU 拡張タイムスタンプ記述子がアクセスユニットごとのずれを、これから来る MPU のぶんまで並べる
+ * (実機のケーブルの BS4K で確かめた。映像は 1 MPU に 32 コマ、音声は 4 フレーム)。
+ * 時刻は NTP の 64 ビットで来るので、ここで **90 kHz** に直す (TS の PTS と同じ物差し。一周はしない)。
+ *
+ * 中身の形式は次のとおり。実機の録りは映像・音声がスクランブルされていて中身を読めないので、どれも推定。
+ *
+ * - 映像 (`hev1`): データユニット 1 つが、長さ (4 バイト) を前に付けた NAL ユニット。MPU は ISO BMFF の形式なので、
+ *   サンプルの中身も MP4 と同じ形と見ている。同じ sample_number のデータユニットが 1 つのコマ
+ * - 音声 (`mp4a`): データユニット 1 つが LATM の AudioMuxElement (LOAS の同期のヘッダーは付かない)。
+ *   MPT の音声コンポーネント記述子の stream_type は 0x11 (LATM/LOAS) だった (確かめた)
+ * - 字幕 (`stpp`): MPU 1 つが TTML の文書 1 つ (`ttml.ts` で読む)。文書の中の画像 (PNG) は扱わない
+ *
+ * スクランブルされたパケットは数えて捨てる (`scrambled`)。復号はエージェントの仕事
+ */
+/** 放送の時刻の物差し (TS の PTS と同じ) */
+export declare const CLOCK = 90000;
+/** NTP の 64 ビットの時刻 (上位 32 ビットが秒、下位 32 ビットが端数) を 90 kHz に */
+export declare function ntpToClock(data: Uint8Array, at: number): number;
+/** MPU タイムスタンプ記述子を読む。`[mpu_sequence_number, 最初の提示時刻 (90 kHz)]` の並び */
+export declare function parseMpuTimestamps(body: Uint8Array): [number, number][];
+/** MPU 拡張タイムスタンプ記述子の、MPU 1 つぶん。時間は `timescale` の単位 */
+export interface MpuExtendedTimestamp {
+    mpuSequenceNumber: number;
+    timescale: number;
+    /** mpu_decoding_time_offset。最初のアクセスユニットの DTS が、最初の提示時刻より前にずれる長さ */
+    decodingOffset: number;
+    /** アクセスユニットごとの、DTS から PTS までのずれ (デコードの順) */
+    dtsPtsOffsets: number[];
+    /** アクセスユニットごとの、次のアクセスユニットの DTS までの長さ (pts_offset) */
+    durations: number[];
+}
+/**
+ * MPU 拡張タイムスタンプ記述子を読む。次のものは DTS を進められないので、空を返す (その MPU は時刻が分からないものとして捨てる)
+ *
+ * - timescale を持たないもの (MPU のメタデータの mdhd を見る、の意味)。放送ではメタデータを送らない
+ * - pts_offset を持たないもの (pts_offset_type 0)。コマの長さが分からない
+ */
+export declare function parseMpuExtendedTimestamps(body: Uint8Array): MpuExtendedTimestamp[];
+/** アクセスユニットの時刻 (90 kHz) */
+export interface UnitTime {
+    pts: number;
+    dts: number;
+    /** 次のアクセスユニットの DTS まで */
+    duration: number;
+}
+/**
+ * MPU の `index` 番目 (デコードの順、0 から) のアクセスユニットの時刻。
+ * DTS は最初の提示時刻から decodingOffset だけ戻った所に始まり、durations を足して進む。
+ * PTS は DTS に dtsPtsOffsets を足したもの。記述子に無い番目なら null
+ */
+export declare function unitTime(presentation: number, extended: MpuExtendedTimestamp, index: number): UnitTime | null;
+/** AAC の設定 (LATM の StreamMuxConfig にある AudioSpecificConfig) */
+export interface AacConfig {
+    /** AudioSpecificConfig のバイト列 (MP4 の esds にそのまま入れる) */
+    audioSpecificConfig: Uint8Array;
+    /** audioObjectType (2 は AAC LC) */
+    objectType: number;
+    sampleRate: number;
+    /** チャンネルの数 (channelConfiguration 7 は 8) */
+    channels: number;
+}
+/**
+ * LATM の AudioMuxElement (muxConfigPresent = 1) から、AAC のフレームを取り出す。
+ * **設定 (StreamMuxConfig) は来たときだけ書いてあり、あいだは「前と同じ」になる** ので、前の設定を覚えておく。
+ *
+ * 読むのは放送で使う形 (番組 1・層 1・サブフレーム 1・frameLengthType 0) だけ。ほかの形は null を返す
+ */
+export declare class LatmReader {
+    private config;
+    read(element: Uint8Array): {
+        config: AacConfig;
+        frame: Uint8Array;
+    } | null;
+    private readStreamMuxConfig;
+}
+export type MediaKind = "video" | "audio" | "caption";
+/** 取り出すアセット (MPT のアセットのうち、映像・音声・字幕のそれぞれ最初のもの) */
+export interface MediaAsset {
+    kind: MediaKind;
+    /** asset_type (`hev1`・`mp4a`・`stpp`) */
+    type: string;
+    packetId: number;
+    /** MH-ストリーム識別記述子の component_tag。無ければ null */
+    componentTag: number | null;
+}
+interface UnitBase extends UnitTime {
+    asset: MediaAsset;
+    mpuSequenceNumber: number;
+}
+/** 映像の 1 コマ */
+export interface VideoUnit extends UnitBase {
+    kind: "video";
+    /** NAL ユニットの並び (長さの前置きを外したもの) */
+    nals: Uint8Array[];
+    /** IRAP (IDR・CRA・BLA) のピクチャを含む */
+    keyframe: boolean;
+}
+/** 音声の 1 フレーム */
+export interface AudioUnit extends UnitBase {
+    kind: "audio";
+    /** AAC のフレーム (LATM を外したもの。ADTS のヘッダーも無い) */
+    frame: Uint8Array;
+    config: AacConfig;
+}
+/** 字幕の文書 1 つ。時刻は MPU の最初の提示時刻 */
+export interface CaptionUnit extends UnitBase {
+    kind: "caption";
+    /** TTML の文書 (UTF-8 を読んだもの) */
+    document: string;
+}
+export type MediaUnit = VideoUnit | AudioUnit | CaptionUnit;
+/**
+ * `MmtMediaReader.feed` が返すもの。選んだアセットが変わったら (番組が替わったときなど)、
+ * 先に `assets` が来る。受け側は組み立て中のもの (fMP4 の初期化セグメント) を作り直す
+ */
+export type MediaEvent = {
+    kind: "assets";
+    assets: MediaAsset[];
+} | MediaUnit;
+/**
+ * 1 局に絞った TLV のバイト列 (`mmt-service-filter.ts`) から、映像・音声・字幕のアクセスユニットを時刻つきで取り出す。
+ *
+ * - 局 (`serviceId` = MMT_package_id) の MPT を読んで、映像・音声・字幕のそれぞれ最初のアセットを選ぶ。
+ *   アセットは MPT と同じ IP の並びのもの (在りかの種類 0) だけを読む
+ * - 時刻は MPT の記述子から引く。時刻がまだ分からない MPU (最初の MPT より先に来たもの) は数えて捨てる (`untimed`)
+ * - パケットが欠けた (packet_sequence_number が続かない) アクセスユニットは捨てる (`dropped`)
+ * - アクセスユニットは、次のアクセスユニット (か次の MPU) の始まりが来たときに返す。最後のものは `end` で返す
+ */
+export declare class MmtMediaReader {
+    private readonly serviceId;
+    private readonly tlv;
+    private readonly ip;
+    private readonly signaling;
+    /** `並び/packet_id` → 組み立て */
+    private tracks;
+    /** 選んだアセットの並び (変わったかを見る) */
+    private selection;
+    /** スクランブルされていて読めなかった MMTP のパケットの数 */
+    scrambled: number;
+    /** 時刻が分からずに捨てたアクセスユニットの数 */
+    untimed: number;
+    /** パケットが欠けたか、中身を読めずに捨てたアクセスユニットの数 */
+    dropped: number;
+    constructor(serviceId: number);
+    /** 選んでいるアセット */
+    get assets(): MediaAsset[];
+    feed(chunk: Uint8Array): Generator<MediaEvent>;
+    /** 終わりまで読んだとき、組み立て中のアクセスユニットを閉じて返す (録画のファイルの最後など) */
+    end(): Generator<MediaUnit>;
+    /** MPT から、アセットを選び直して時刻を覚える */
+    private readMpt;
+    /** MPU のパケットの中身を 1 つ読む */
+    private readMpu;
+    /** データユニット (分割したものはその断片) を 1 つ受ける。ヘッダーは断片ごとに付いている */
+    private dataUnit;
+    private keep;
+    /** 組み立て中のアクセスユニットを閉じて返す */
+    private finish;
+}
+export {};