NDGRClient: Nicolive NDGR Message Server Client Library & Command Line Tool
2024/08/05 から ニコニコ生放送 で運用されている NDGR メッセージサーバーのクライアントライブラリと、ライブラリを活用したコマンドラインツールです。
主に ニコニコ実況 のコメントを取得する用途での利用を想定しています。
Tip
このライブラリは、JKCommentCrawler (ニコニコ実況の過去ログ収集ツール) において、NDGR メッセージサーバーからの過去ログ取得処理に活用されています。
https://mpn.live.nicovideo.jp
以下で運用されている API サーバーのことを便宜的にそう呼称しています。NDGR
は「のどぐろ」を意味するコードネームのようです。
Tip
ニコニコ生放送・ニコニコ生放送 (Re:仮) で運用されているものと同一設計のサーバーのクライアント実装が、05/21 時点で実際に N Air (ニコ生配信者向けに公開されている Streamlabs OBS のフォーク) のソースコード に NdgrClient
として追加されていることが確認できます。
サイバー攻撃以前のニコ生では、視聴リクエスト・統計情報・コメントの送受信などをすべて WebSocket API で送受信していました。
具体的には、視聴開始リクエスト・コメント送信・統計情報の受信・座席の維持などを行う「視聴セッション維持用 WebSocket API」と、(運営コマンドやニコニ広告などの特殊コメントを含む)「コメント受信用 WebSocket API」の両方に WebSocket 接続を行う必要がありました。
NDGR メッセージサーバーは従来の「コメント受信用 WebSocket API」(niwavided メッセージサーバー) の代替で、通信プロトコルが従来の WebSocket での JSON 送受信から「Protobuf 形式のバイナリを Length-Delimited Protobuf Stream として返す HTTP ストリーミング API の定期的なポーリング」に変更されている点が最大の特徴です。
Tip
従来のメッセージサーバーの通信プロトコルは、Flash 時代の XMLSocket のデータ構造をそのまま WebSocket + JSON に置き換えただけの代物で、極めてレガシーな仕様を長年引き摺っていました。
今回刷新された新メッセージサーバーでは Protobuf によりメッセージが構造化されており、今まで /nicoad
などの特殊コメントとして実装されていた生放送制御用メッセージが明確に分離されたりなどのモダン化を果たしています。
Tip
エンドユーザーからすると「コメントサーバー」の方が自然な呼び方に思えますが、従来から通常のコメントに混じって生放送の進行状況やニコニ広告などの制御用メッセージも送られていることから、ドワンゴ内部では「コメント」と「制御用メッセージなど」をまとめて「メッセージ」と呼び、それを届けるサーバーなので「メッセージサーバー」と呼んでいるようです。
AWS 上で稼働していること、またこのような高度な仕組みは数週間で実装できるようなものではないことから、以前から進行していたニコ生の AWS 載せ替え & フルリニューアル時に、従来のメッセージサーバーを新規開発でクラウドネイティブな NDGR メッセージサーバーで置き換え予定だったと考えられます。
今回急遽 AWS 上にニコニコ生放送 (Re:仮) 用のメッセージサーバーを構築する必要に迫られ、当時開発途上だった NDGR メッセージサーバーを急遽ニコニコ生放送 (Re:仮) にて前倒して運用開始した、と考えるのが自然です。
その後 2024/08/05 に復旧したニコニコ生放送では、サービス開始当初から使われてきた従来のメッセージサーバーに代わり、NDGR メッセージサーバーの本運用が開始されました。
これに伴い旧メッセージサーバーにはアクセスできなくなり (タイムシフト用の過去ログは後日新メッセージサーバーにインポート予定とのこと) 、各コメントビューアーでも新メッセージサーバーへの対応が必須となっています。
poetry run python -m ndgr_client stream <nicolive_program_id or jikkyo_id>
指定したニコニコ生放送 ID (ex: lv345479988) または実況チャンネル ID (ex: jk1, jk9, jk211) に対応する番組に投稿されたコメントを、リアルタイムにコンソールに表示します。
終了するにはコンソールで Ctrl+C
を入力してください。
Tip
--verbose
オプションを付けると、詳細な動作ログが出力されます。
poetry run python -m ndgr_client download <nicolive_program_id or jikkyo_id> --output-dir <output_dir>
指定したニコニコ生放送 ID (ex: lv345479988) または実況チャンネル ID (ex: jk1, jk9, jk211) に対応する番組に投稿された、過去すべてのコメントを一括でダウンロードし、(output_dir)/(nicolive_program_id or jikkyo_id).nicojk
に保存します。
--output-dir
を指定しない場合、カレントディレクトリに保存されます。
コメントは最新のものから過去に遡るようにまとめて取得され、取得されたコメントは随時コンソールに表示されます。
Tip
jikkyo_id
に all
を指定すると、すべてのニコニコ実況チャンネルのコメントを一括でダウンロードできます。
Tip
--verbose
オプションを付けると、詳細な動作ログが出力されます。
今のところ PyPI には公開していませんが、GitHub の URL を指定してインストールできます。
pip install git+https://github.com/tsukumijima/NDGRClient
@rinsuki (https://github.com/rinsuki-lab/ndgr-reader)
Note
proto/ 以下の .proto ファイルは、n-air-app/nicolive-comment-protobuf からインポートしたものです。