Skip to content

Getting Started

github-actions[bot] edited this page Mar 21, 2026 · 1 revision

Getting Started

前提条件

TCNetプロトコルでデータを送信するソフトウェアが必要。

  • PRO DJ LINK Bridge (Windows / Mac) -- Pioneer DJ機器のデータをTCNetに変換する
  • ShowKontrol (Mac) -- TCNet対応のショーコントローラー
  • Beatkontrol (Mac) -- BPM同期ツール

インストール

npm install @9c5s/node-tcnet

基本的な使い方

import { TCNetClient, TCNetConfiguration } from "@9c5s/node-tcnet";

const config = new TCNetConfiguration();
config.broadcastInterface = "10GbE"; // Windowsのネットワークインターフェース名

const client = new TCNetClient(config);

// connect前にイベントハンドラを登録する
// broadcastイベントでStatus/OptInを受信する
client.on("broadcast", (packet) => {
  console.log(packet);
});

// dataイベントでMetrics/Metadataを受信する
client.on("data", (packet) => {
  console.log(packet);
});

await client.connect();

await client.disconnect();

メタデータの取得

requestDataメソッドで特定のデータを要求できる。

import {
  TCNetDataPacketType,
  TCNetDataPacketMetadata,
} from "@9c5s/node-tcnet";

const meta = await client.requestData(TCNetDataPacketType.MetaData, 0); // layer 0 (0-based)
if (meta instanceof TCNetDataPacketMetadata && meta.info) {
  console.log(meta.info.trackArtist, meta.info.trackTitle);
}

Windowsでの注意点

broadcastInterfaceにはOSのネットワークインターフェース名を指定する。 名前は「ネットワーク接続」画面やos.networkInterfaces()で確認できる。

import os from "os";
console.log(Object.keys(os.networkInterfaces()));
// 例: [ 'Ethernet', '10GbE', 'Wi-Fi', 'Loopback Pseudo-Interface 1' ]

次のステップ

トラブルシューティングはPRO DJ LINK Bridgeを参照。

Clone this wiki locally