@danything/arib 2.0.0 → 2.1.0

package/README.md

@@ -1,9 +1,9 @@
 # @danything/arib
 
-日本のデジタル放送 (ISDB-T / ISDB-S、ARIB 規格) の MPEG-TS を TypeScript で読むライブラリです。
+日本のデジタル放送 (ISDB-T / ISDB-S / ISDB-C、ARIB 規格) の MPEG-TS を TypeScript で読むライブラリです。
 録画サーバ [denpa](https://github.com/danything/denpa) の中で使っているものを切り出しました。
 
-- PSI (`psi`): パケットの切り出し、セクションの組み立て、PAT / PMT / SDT / NIT。衛星はネットワークの全部の TS の NIT と、ほかの TS の SDT もそろえて読む
+- PSI (`psi`): パケットの切り出し、セクションの組み立て、PAT / PMT / SDT / NIT。衛星はネットワークの全部の TS の NIT と、ほかの TS の SDT もそろえて読む。ケーブルは SDT だけで局をそろえる
 - 映像・音声の PES と ADTS を取り出す (`pes`)
 - 番組表の EIT[p/f] と EIT[schedule] を、ジャンル・音声・拡張形式イベント・シリーズ記述子まで読む。放送の時刻 (TDT / TOT) もここ (`eit`)
 - ARIB STD-B24 の 8 単位符号 (JIS X 0213 の 1 面・2 面まで) と ARIB 外字を文字列にする (`aribtext`、`aribtext-gaiji`)

package/dist/b24caption.js

@@ -299,13 +299,16 @@ export class B24CaptionDecoder {
             return;
         const found = [];
         for (let i = 0; i < languages; i++) {
-            if (at + 6 > data.length)
+            if (at + 5 > data.length)
                 return;
             const tag = data[at] >> 5;
             const dmf = data[at] & 0x0f;
             at += 1;
+            // DC (表示モード) が 1 バイト挟まる
             if (dmf === 0b1100 || dmf === 0b1101 || dmf === 0b1110)
                 at += 1;
+            if (at + 4 > data.length)
+                return;
             const code = ascii(data, at, 3);
             at += 3; // ISO 639
             const format = data[at] >> 4;

package/dist/eit.js

@@ -159,10 +159,12 @@ function readDescriptors(event, body) {
     for (const [tag, data] of descriptors(body)) {
         switch (tag) {
             case DESC_SHORT_EVENT: {
+                if (data.length < 4)
+                    break;
                 const nameLength = data[3];
                 const textAt = 4 + nameLength;
                 event.name = decodeAribText(data.subarray(4, textAt));
-                const textLength = data[textAt];
+                const textLength = data[textAt] ?? 0;
                 event.description = decodeAribText(data.subarray(textAt + 1, textAt + 1 + textLength));
                 break;
             }
@@ -199,6 +201,9 @@ function readDescriptors(event, body) {
                 break;
             }
             case DESC_COMPONENT: {
+                // 短いものを読むと、種別 0 の「480i」と出る
+                if (data.length < 2)
+                    break;
                 const streamContent = data[0] & 0x0f;
                 const componentType = data[1];
                 event.video = {
@@ -221,6 +226,9 @@ function readDescriptors(event, body) {
              *     [残り]   text_char … **放送が付けた名前**
              */
             case DESC_AUDIO_COMPONENT: {
+                // 言語の符号まで無いものを読むと、言語が空の音声が 1 本増える
+                if (data.length < 9)
+                    break;
                 const flags = data[5];
                 const multiLingual = (flags & 0x80) !== 0;
                 const langs = [lang(data, 6)];
@@ -245,7 +253,7 @@ function readDescriptors(event, body) {
             case DESC_CA_CONTRACT_INFO: {
                 if (data.length < 4)
                     break;
-                const caSystemId = (data[0] << 8) | data[1];
+                const caSystemId = u16(data, 0);
                 const numOfComponent = data[2] & 0x0f;
                 let at = 3 + numOfComponent;
                 if (at >= data.length)

package/dist/psi.d.ts

@@ -1,7 +1,7 @@
 /**
  * TS の土台 (パケットの切り出し・セクションの組み立て・PAT/PMT) と、局の一覧。
  * 局の一覧はチャンネルスキャンで「この物理チャンネルに何が入っているか」を知るために使い、
- * 読むのは NIT と SDT の 2 つ。
+ * 読むのは NIT と SDT の 2 つ。ケーブルでは、局の無い TS を見分けるのに PAT も読む (`ServiceReader`)。
  *
  * - NIT (PID 0x0010) … ネットワーク ID と、地上波ならリモコン番号。衛星はネットワークの全部の TS
  *   (TSID・周波数・サービスの一覧) が載っている (`NitReader`)
@@ -48,8 +48,9 @@ export interface TransportInfo {
 }
 export interface NetworkInfo {
     networkId: number;
+    /** 最初の TS のリモコン番号。地上波の NIT は自分の TS 1 つだけを載せる */
     remoteControlKeyId: number | null;
-    transportStreams: TransportInfo[];
+    transportStreams: NetworkTransport[];
 }
 /**
  * PSI セクションを組み立てる。
@@ -182,6 +183,8 @@ export type Delivery = SatelliteDelivery | TerrestrialDelivery;
 /** NIT の TS の 1 件。サービスの一覧に、どこで流れているかが付く */
 export interface NetworkTransport extends TransportInfo {
     delivery: Delivery | null;
+    /** その TS のリモコン番号 (TS 情報記述子)。載せていなければ null */
+    remoteControlKeyId: number | null;
 }
 /** そろった NIT。セクションをつないだもの */
 export interface Network {
@@ -259,13 +262,26 @@ export interface FoundService extends Service {
  * Mirakurun のスキャンと同じで、**両方**揃って初めてそのチャンネルを
  * 「受信できた」とみなす。SDT だけ取れても、どのネットワークのものか
  * 分からないと設定に書けない。
+ *
+ * **ケーブル (`requireNit: false`) は SDT[actual] だけで揃ったとみなす。** 1 つのネットワークが
+ * 地上波・BS の再送信と自主放送の TS をまとめて流していて、NIT は CATV のネットワークのもの
+ * (局の元の放送とは別)。どの放送の局かは SDT の original_network_id で分かる。
+ * NIT が先に来ていれば、その TS のリモコン番号だけを使う。
+ * PAT に局が 1 つも無い TS (データだけの TS) も揃ったとみなし、局は返さない (`empty`)
  */
 export declare class ServiceReader {
     private readonly nit;
     private readonly sdt;
+    private readonly pat;
     private readonly packets;
+    private readonly requireNit;
     network: NetworkInfo | null;
     transport: TransportInfo | null;
+    /** PAT に局が 1 つも無かった (`requireNit: false` のときだけ読む) */
+    empty: boolean;
+    constructor({ requireNit }?: {
+        requireNit?: boolean;
+    });
     get complete(): boolean;
     /** 任意の長さのバイト列を渡す。揃ったら true */
     feed(chunk: Uint8Array): boolean;

package/dist/psi.js

@@ -1,7 +1,7 @@
 /**
  * TS の土台 (パケットの切り出し・セクションの組み立て・PAT/PMT) と、局の一覧。
  * 局の一覧はチャンネルスキャンで「この物理チャンネルに何が入っているか」を知るために使い、
- * 読むのは NIT と SDT の 2 つ。
+ * 読むのは NIT と SDT の 2 つ。ケーブルでは、局の無い TS を見分けるのに PAT も読む (`ServiceReader`)。
  *
  * - NIT (PID 0x0010) … ネットワーク ID と、地上波ならリモコン番号。衛星はネットワークの全部の TS
  *   (TSID・周波数・サービスの一覧) が載っている (`NitReader`)
@@ -481,11 +481,11 @@ function parseNitSection(section) {
         at += 6 + loop;
         const services = [];
         let delivery = null;
+        let remote = null;
         for (const [tag, descriptor] of descriptors(body)) {
-            if (tag === DESC_TS_INFORMATION &&
-                descriptor.length > 0 &&
-                remoteControlKeyId === null) {
-                remoteControlKeyId = descriptor[0];
+            if (tag === DESC_TS_INFORMATION && descriptor.length > 0) {
+                remote ??= descriptor[0];
+                remoteControlKeyId ??= remote;
             }
             else if (tag === DESC_SERVICE_LIST) {
                 for (let i = 0; i + 3 <= descriptor.length; i += 3) {
@@ -508,13 +508,13 @@ function parseNitSection(section) {
             originalNetworkId,
             services,
             delivery,
+            remoteControlKeyId: remote,
         });
     }
     return {
         other: tableId === TABLE_NIT_OTHER,
         networkId: u16(section, 3),
         version: (section[5] >> 1) & 0x1f,
-        current: (section[5] & 0x01) !== 0,
         sectionNumber: section[6],
         lastSectionNumber: section[7],
         remoteControlKeyId,
@@ -716,15 +716,30 @@ export class SdtReader {
  * Mirakurun のスキャンと同じで、**両方**揃って初めてそのチャンネルを
  * 「受信できた」とみなす。SDT だけ取れても、どのネットワークのものか
  * 分からないと設定に書けない。
+ *
+ * **ケーブル (`requireNit: false`) は SDT[actual] だけで揃ったとみなす。** 1 つのネットワークが
+ * 地上波・BS の再送信と自主放送の TS をまとめて流していて、NIT は CATV のネットワークのもの
+ * (局の元の放送とは別)。どの放送の局かは SDT の original_network_id で分かる。
+ * NIT が先に来ていれば、その TS のリモコン番号だけを使う。
+ * PAT に局が 1 つも無い TS (データだけの TS) も揃ったとみなし、局は返さない (`empty`)
  */
 export class ServiceReader {
     nit = new SectionAssembler(PID_NIT);
     sdt = new SectionAssembler(PID_SDT);
+    pat = new SectionAssembler(PID_PAT);
     packets = new PacketStream();
+    requireNit;
     network = null;
     transport = null;
+    /** PAT に局が 1 つも無かった (`requireNit: false` のときだけ読む) */
+    empty = false;
+    constructor({ requireNit = true } = {}) {
+        this.requireNit = requireNit;
+    }
     get complete() {
-        return this.network !== null && this.transport !== null;
+        return this.requireNit
+            ? this.network !== null && this.transport !== null
+            : this.transport !== null || this.empty;
     }
     /** 任意の長さのバイト列を渡す。揃ったら true */
     feed(chunk) {
@@ -739,16 +754,22 @@ export class ServiceReader {
                     this.transport = parseSdt(section) ?? this.transport;
                 }
             }
+            if (!this.requireNit && !this.empty && this.transport === null) {
+                for (const section of this.pat.feed(packet)) {
+                    if (section[0] === TABLE_PAT && parsePat(section).size === 0)
+                        this.empty = true;
+                }
+            }
         }
         return this.complete;
     }
     /** 録るに値するサービスだけ。リモコン番号は NIT のものを配る */
     services() {
-        if (this.network === null || this.transport === null)
+        const transport = this.transport;
+        if (transport === null)
             return [];
-        const { networkId, remoteControlKeyId } = this.network;
-        const { transportStreamId } = this.transport;
-        return this.transport.services
+        const { transportStreamId, originalNetworkId } = transport;
+        const found = (networkId, remoteControlKeyId) => transport.services
             .filter((service) => SERVICE_TYPES.has(service.serviceType))
             .map((service) => ({
             ...service,
@@ -756,5 +777,13 @@ export class ServiceReader {
             transportStreamId,
             remoteControlKeyId,
         }));
+        if (this.requireNit) {
+            if (this.network === null)
+                return [];
+            return found(this.network.networkId, this.network.remoteControlKeyId);
+        }
+        const own = this.network?.transportStreams.find((ts) => ts.transportStreamId === transportStreamId &&
+            ts.originalNetworkId === originalNetworkId);
+        return found(originalNetworkId, own?.remoteControlKeyId ?? null);
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@danything/arib",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "description": "日本のデジタル放送 (ARIB) の TS を読む: PSI・PES・EIT・ARIB の文字・字幕・データ放送",
   "license": "MIT",
   "repository": {