@danything/arib 2.1.0 → 2.3.0

package/dist/mmt-service-filter.js

@@ -0,0 +1,166 @@
+/**
+ * チャンネル丸ごとの TLV のバイト列から、1 つの局のぶんだけを抜き出す。TS の `service-filter.ts` に当たり、
+ * 出力も TLV のバイト列のまま (TLV のパケットを 1 バイトも変えずに、残すものだけを並べる)。
+ *
+ * 局を見分けるのは MPT (MMT_package_id が service_id)。MPT は IP の並び (`tlv-ip.ts` の `flow`) の中を
+ * 運ばれ、MMTP の packet_id はその並びの中でだけ決まっているので、残すかどうかは並びと packet_id の組で決める。
+ *
+ * - 残す … TLV-SI (TLV-NIT など)、IP のヘッダーを圧縮していない IP (NTP)、その局の MPT が載った並びの信号
+ *   (PLT・MPT・番組表・ECM)、その局の MPT が挙げるアセット (映像・音声・字幕) の MPU
+ * - 落とす … 詰め物、ほかの局の MPT とそのアセット、PLT がほかの局だけを挙げている並び
+ *
+ * 実機のケーブルの BS4K は、1 つの TLV のストリームに局が 1 つ (IP の並びも 1 つ) だったので、たいていは
+ * 詰め物のほかは全部残る。AMT (局ごとの IP の宛先) は 0.8 秒の間に来なかったので使わない。
+ * MPT は 0.1 秒おきに来ていた
+ */
+import { concatBytes } from "./bytes.js";
+import { parseMpt, parsePlt, TABLE_MPT, TABLE_PLT, } from "./mmt-si.js";
+import { MESSAGE_PA, messageTables, parseMessage, parseMmtp, PAYLOAD_SIGNALING, SignalingAssembler, } from "./mmtp.js";
+import { TlvIpReader } from "./tlv-ip.js";
+import { TLV_COMPRESSED_IP, TLV_NULL, TlvStream } from "./tlv.js";
+/**
+ * MPT を読むまで取っておく TLV のパケットの数の上限。**選局したての先頭を捨てない** (`ServiceFilter` と同じ)。
+ * MPT は 0.1 秒おきに来るので、38 Mbps でもふつうは 400 個ほどで足りる
+ */
+const HOLD_MOST = 8192;
+/**
+ * 1 つの局に絞る。
+ *
+ * その局の MPT を読むまでは、MPU (映像・音声) を出さずに取っておき、読んだら MPT の後ろに出す
+ * (並びは届いた順のまま)。信号は待たずに出す
+ */
+export class MmtServiceFilter {
+    serviceId;
+    tlv = new TlvStream();
+    ip = new TlvIpReader();
+    signaling = new SignalingAssembler();
+    flows = new Map();
+    held = [];
+    mptNow = null;
+    /** @param serviceId 残す局 (MPT の MMT_package_id) */
+    constructor(serviceId) {
+        this.serviceId = serviceId;
+    }
+    /** その局の MPT を読めたか。読めるまで映像と音声は 1 バイトも出ない (届いたものは取っておく) */
+    get ready() {
+        return this.mptNow !== null;
+    }
+    /** 最後に読んだ、その局の MPT。読むまでは null */
+    get mpt() {
+        return this.mptNow;
+    }
+    /** 任意の長さの TLV のバイト列を渡すと、残すぶんを返す */
+    filter(chunk) {
+        const out = [];
+        for (const packet of this.tlv.feed(chunk)) {
+            if (packet.type === TLV_NULL)
+                continue;
+            // MMTP は圧縮した IP で来る。TLV-SI と、圧縮していない IP (NTP) はそのまま残す
+            if (packet.type !== TLV_COMPRESSED_IP) {
+                out.push(packet.bytes);
+                continue;
+            }
+            const datagram = this.ip.read(packet);
+            const mmtp = datagram === null ? null : parseMmtp(datagram.payload);
+            if (datagram === null || mmtp === null)
+                continue;
+            const flow = this.flow(datagram.flow);
+            const packetId = mmtp.packetId;
+            // ほかの局だけの並びでも信号は読み続ける (後の PLT がこの局を挙げたら出し始める)。出すかは読んだあとで決める
+            if (mmtp.payloadType === PAYLOAD_SIGNALING) {
+                const before = flow.own;
+                for (const raw of this.signaling.feed(datagram.flow, mmtp))
+                    this.readSignaling(flow, raw);
+                if (flow.foreign || flow.foreignMpt.has(packetId))
+                    continue;
+                out.push(packet.bytes);
+                // MPT を読んだ (読み直した)。取っておいたもののうち、この局のぶんを出す
+                if (flow.own !== null && flow.own !== before)
+                    this.release(out);
+                continue;
+            }
+            if (flow.foreign)
+                continue;
+            if (flow.own === null)
+                this.hold(datagram.flow, packetId, packet.bytes);
+            else if (flow.own.has(packetId))
+                out.push(packet.bytes);
+        }
+        return concatBytes(out);
+    }
+    flow(key) {
+        let flow = this.flows.get(key);
+        if (flow === undefined) {
+            flow = { foreignMpt: new Set(), foreign: false, own: null };
+            this.flows.set(key, flow);
+        }
+        return flow;
+    }
+    readSignaling(flow, raw) {
+        const message = parseMessage(raw);
+        if (message === null || message.messageId !== MESSAGE_PA)
+            return;
+        for (const table of messageTables(message)) {
+            if (table[0] === TABLE_PLT) {
+                const plt = parsePlt(table);
+                if (plt === null)
+                    continue;
+                flow.foreignMpt.clear();
+                let mine = false;
+                for (const { packageId, location } of plt.packages) {
+                    if (packageId === this.serviceId)
+                        mine = true;
+                    else if (location.type === 0 && location.packetId !== null)
+                        flow.foreignMpt.add(location.packetId);
+                }
+                flow.foreign = !mine && plt.packages.length > 0;
+            }
+            else if (table[0] === TABLE_MPT) {
+                // 持ち続けるのでコピーする (表は届いたチャンクの一部を指す。`TlvStream`)
+                const mpt = parseMpt(table.slice());
+                if (mpt === null || mpt.packageId !== this.serviceId)
+                    continue;
+                this.mptNow = mpt;
+                flow.own = ownPacketIds(mpt);
+            }
+        }
+    }
+    /** MPT を読む前のパケットを取っておく。**コピーする** (パケットは届いたチャンクの一部を指す。`TlvStream`) */
+    hold(flow, packetId, bytes) {
+        this.held.push({ flow, packetId, bytes: bytes.slice() });
+        // 溢れたら古い半分を捨てる (`ServiceFilter` と同じ)
+        if (this.held.length > HOLD_MOST)
+            this.held = this.held.slice(this.held.length - HOLD_MOST / 2);
+    }
+    release(out) {
+        const rest = [];
+        for (const held of this.held) {
+            const flow = this.flows.get(held.flow);
+            // ほかの局だけの並びと分かったものは捨てる。まだ分からない並びのものは取っておく
+            if (flow === undefined || flow.foreign)
+                continue;
+            if (flow.own === null)
+                rest.push(held);
+            else if (flow.own.has(held.packetId))
+                out.push(held.bytes);
+        }
+        this.held = rest;
+    }
+}
+/** MPT が挙げる、同じ IP の並びの packet_id (アセットと ECM) */
+function ownPacketIds(mpt) {
+    const ids = new Set();
+    const add = (location) => {
+        if (location.type === 0 && location.packetId !== null)
+            ids.add(location.packetId);
+    };
+    for (const access of mpt.access)
+        add(access.location);
+    for (const asset of mpt.assets) {
+        for (const location of asset.locations)
+            add(location);
+        for (const access of asset.access)
+            add(access.location);
+    }
+    return ids;
+}

package/dist/mmt-si.d.ts

@@ -0,0 +1,183 @@
+/**
+ * 4K の放送 (MMT/TLV) の信号の表を読む (ARIB STD-B60、TLV-SI は ARIB STD-B32 第 3 部)。
+ * TS の `psi.ts` に当たる。
+ *
+ * 表は 2 か所から来る。
+ *
+ * - TLV-SI (TLV の種類 0xFE) … TLV-NIT。TS の NIT と同じ形式のセクションで、記述子も TS と同じ (タグ 1 バイト)
+ * - MMTP の信号メッセージ (`mmtp.ts`) … PA メッセージの PLT・MPT と、M2 セクションメッセージの MH-SDT・MH-EIT・MH-TOT・ECM。
+ *   記述子のタグは 2 バイトで、**タグが 0xF000 未満なら長さは 1 バイト、0xF000 以上なら 2 バイト**
+ *
+ * 局名や番組名の文字は UTF-8 (TS の ARIB の 8 単位符号ではない)。
+ * 実機のケーブルの BS4K では、PLT・MPT・MH-SDT[other]・MH-EIT・TLV-NIT を読めた。どれもスクランブルされていない。
+ */
+import { type FoundService, type Service } from "./psi.js";
+export declare const TABLE_MPT = 32;
+export declare const TABLE_PLT = 128;
+/** 局名・番組名の文字 (UTF-8)。壊れた並びは U+FFFD になる */
+export declare function mmtText(data: Uint8Array): string;
+/** MMT の記述子の並びを (タグ, 中身) に切り分ける。タグが 0xF000 以上なら長さは 2 バイト */
+export declare function mmtDescriptors(data: Uint8Array): Generator<[number, Uint8Array]>;
+/** TLV-SI の中身を、セクションに切り分ける。詰め物 (0xFF) から先は無い。壊れたセクションは落とす */
+export declare function tlvSiSections(payload: Uint8Array): Uint8Array[];
+/**
+ * MMT のパケットの在りか (MMT_general_location_info)。
+ * 0 は同じ IP の並びの packet_id、1 と 2 はほかの IPv4・IPv6 の並びの packet_id、5 は URL
+ */
+export interface MmtLocation {
+    type: number;
+    /** 0・1・2 のとき */
+    packetId: number | null;
+    /** 1・2 のときの宛先 */
+    destination: string | null;
+    destinationPort: number | null;
+}
+export interface PltPackage {
+    /** MMT_package_id。放送では service_id と同じ値 */
+    packageId: number;
+    /** その package の MPT の在りか */
+    location: MmtLocation;
+}
+export interface Plt {
+    version: number;
+    packages: PltPackage[];
+}
+/**
+ * PLT (package list table)。**どの package の MPT がどの packet_id で来るか**を持つ。
+ * IP で運ぶもの (IP_delivery) の並びは読まない
+ */
+export declare function parsePlt(table: Uint8Array): Plt | null;
+/** スクランブルの方式と、ECM の在りか (アクセス制御記述子) */
+export interface AccessControl {
+    /** CA_system_id。B-CAS と同じ 0x0005 でも、4K の放送の ECM は B-CAS のカードでは読めない */
+    caSystemId: number;
+    location: MmtLocation;
+}
+export interface MptAsset {
+    /** asset_type。映像 `hev1`、音声 `mp4a`、字幕 `stpp` など */
+    type: string;
+    assetId: Uint8Array;
+    locations: MmtLocation[];
+    /** MH-ストリーム識別記述子の component_tag。無ければ null */
+    componentTag: number | null;
+    /** そのアセットにだけ掛かるアクセス制御記述子 */
+    access: AccessControl[];
+    /** アセットの記述子の並び (`mmtDescriptors` で読む) */
+    descriptors: Uint8Array;
+}
+export interface Mpt {
+    version: number;
+    /** MMT_package_id。放送では service_id と同じ値 */
+    packageId: number;
+    /** package 全体に掛かるアクセス制御記述子 */
+    access: AccessControl[];
+    /** package 全体の記述子の並び */
+    descriptors: Uint8Array;
+    assets: MptAsset[];
+}
+/**
+ * MPT (MMT package table)。**局の中身の一覧**で、TS の PMT に当たる。
+ * アセット (映像・音声・字幕) ごとに、型と packet_id と記述子を持つ。読めない在りかの種類が来たら、
+ * そこまでに読めたアセットを返す
+ */
+export declare function parseMpt(table: Uint8Array): Mpt | null;
+export interface MhService extends Service {
+    /** 事業者名 (MH-サービス記述子) */
+    providerName: string;
+    /**
+     * free_CA_mode が 0 か。**復号が要るかの判断には使えない。** 実機の BS4K は 0 なのに、映像と音声は
+     * スクランブルされていた。スクランブルされているかは MPT のアクセス制御記述子と、MMTP の印で見る
+     */
+    isFree: boolean;
+    eitSchedule: boolean;
+    eitPresentFollowing: boolean;
+}
+export interface MhSdt {
+    /** MH-SDT[other] (ほかの TLV のストリームのもの) なら true */
+    other: boolean;
+    tlvStreamId: number;
+    originalNetworkId: number;
+    version: number;
+    sectionNumber: number;
+    lastSectionNumber: number;
+    services: MhService[];
+}
+/** MH-SDT。局名と種類。TS の SDT と同じ並びで、記述子と文字が MMT のもの */
+export declare function parseMhSdt(section: Uint8Array): MhSdt | null;
+/** TLV-NIT の TLV のストリームの 1 件 */
+export interface TlvNetworkStream {
+    tlvStreamId: number;
+    originalNetworkId: number;
+    /** サービスリスト記述子の局 (service_id と種類) */
+    services: {
+        serviceId: number;
+        serviceType: number;
+    }[];
+    /** 記述子の並び (TS と同じタグ 1 バイトのもの。`psi.descriptors` で読む) */
+    descriptors: Uint8Array;
+}
+export interface TlvNetwork {
+    /** TLV-NIT[other] なら true */
+    other: boolean;
+    networkId: number;
+    version: number;
+    sectionNumber: number;
+    lastSectionNumber: number;
+    /** ネットワーク名 (UTF-8)。「高度ＢＳデジタル放送」 */
+    name: string;
+    streams: TlvNetworkStream[];
+}
+/** TLV-NIT。TS の NIT と同じ並びで、TS の代わりに TLV のストリームが並ぶ */
+export declare function parseTlvNit(section: Uint8Array): TlvNetwork | null;
+/** MH-TOT から放送の現在時刻 (epoch ms) を読む。TS の TOT と同じく、table_id のあとに MJD + BCD の 5 バイト */
+export declare function parseMhTot(section: Uint8Array): number | null;
+/** 信号の表 1 つと、どこから来たか */
+export interface MmtTable {
+    /** IP の並び (`tlv-ip.ts` の `flow`)。TLV-SI なら null */
+    flow: string | null;
+    /** 運んだ MMTP の packet_id。TLV-SI なら null */
+    packetId: number | null;
+    /** 表の先頭 (table_id) から。M2 セクションと TLV-SI は CRC32 を確かめてある */
+    table: Uint8Array;
+}
+/**
+ * TLV のバイト列から、信号の表を全部取り出す。番組表 (`mh-eit.ts`) や局の一覧を読むところの入口で、
+ * TS で `PacketStream` と `SectionAssembler` を並べるのに当たる。
+ *
+ * MPU (映像・音声) の MMTP は、ヘッダーだけ読んで読み飛ばす
+ */
+export declare class MmtTableStream {
+    private readonly tlv;
+    private readonly ip;
+    private readonly signaling;
+    feed(chunk: Uint8Array): Generator<MmtTable>;
+}
+/**
+ * 流れてくる TLV を読んで、局の一覧を作る。**TS の `ServiceReader` に当たる** (チャンネルスキャンで使う)。
+ *
+ * TLV-NIT[actual] と MH-SDT[actual] が両方来たら揃ったとみなす。局は MH-SDT[actual] のもので、
+ * 局の元の放送は MH-SDT の original_network_id (ケーブルで受けた BS4K なら 0x000B)、TSID の代わりに tlv_stream_id を入れる。
+ * TLV にはリモコン番号が無い (TLV-NIT に見当たらない) ので null。
+ *
+ * 局ごとの CA_system_id は、PLT から package (= service_id) の MPT を引き、そのアクセス制御記述子から読む (`caSystemIdsOf`)。
+ * free_CA_mode は使わない。実機の BS4K は 0 なのに、映像と音声はスクランブルされていた
+ */
+export declare class TlvServiceReader {
+    private readonly tables;
+    private plt;
+    /** package_id (= service_id) → MPT */
+    private readonly mpts;
+    network: TlvNetwork | null;
+    transport: MhSdt | null;
+    get complete(): boolean;
+    /** PLT が来て、そこにある package の MPT が全部 1 回は来たか。スキャンで、局ごとの CA_system_id が分かるまで少し長く読むのに使う */
+    get mptsKnown(): boolean;
+    /** 任意の長さのバイト列を渡す。揃ったら true */
+    feed(chunk: Uint8Array): boolean;
+    /** 録画の対象になる種類の局だけ (`psi.SERVICE_TYPES`)。揃うまでは空 */
+    services(): FoundService[];
+    /** その局の MPT のアクセス制御記述子 (package 全体とアセットのもの)。MPT が来なかった局は空 */
+    accessOf(serviceId: number): AccessControl[];
+    /** その局の CA_system_id (重なりなし・小さい順)。アクセス制御記述子が無い・MPT が来なかった局は空 */
+    caSystemIdsOf(serviceId: number): number[];
+}