PARAKNOT_ver1.0.0

音声の伝送

• モード : 音声の向き（送信 / 受信）と接続の向き（待受 / 接続）の組み合わせで 4 通り: 配信（送信・待受）/ 受信(接続) / 受信(待受) / 送信（送信・接続）
• チャンネル数 : メイン最大 12ch + サブ最大 4ch = 最大 16ch
• チャンネル構成 : プリセット（Monaural / Stereo / LCR(3.0) / Quad(4.0) / 5.1 / 7.1 / 7.1.4）から選ぶか、チャンネル数を増減して指定。チャンネルごとに名前を付けられる
• メーター : チャンネルごとに入力レベルを表示
• 受信側の追従 : 受信側のチャンネル数とチャンネル名は、送信側の構成に自動で合わせる

送信時の変換

• そのまま : 選んだチャンネル構成（メイン + サブ）をそのまま送信
• ダウンミックス(2ch) : メインを ITU-R BS.775 準拠の係数でステレオへ変換して送信
• アンビソニックス : 入力の先頭 4ch を Ambisonics マイクの A-format（1 次）として扱い、B-format へ変換してからデコードして送信

Ambisonics

• A-format → B-format 変換 : マイクの形状（配列半径・カプセルの向き・指向性）に基づく補正付きの変換。前段に変換用のプラグインを挿す必要は無い
• マイクプリセット : Default Preset（汎用）/ RODE NT-SF1 / Sennheiser AMBEO VR Mic を同梱。YAML ファイルで追加・編集できる
• デコード先 : そのまま(B-format・4ch) / モノラル / ステレオ / 5.1 / 7.1.4
• 向き : 音場を水平方向に回転（±180°）
• パススルー : デコード出力に加えて、入力の 5ch 目以降をそのまま送信できる

接続・セキュリティ

• 接続先の選択 : RIGDOCKS Bridge のクライアントタブに登録した接続先から選ぶ。相手が複数の PARAKNOT を動かしている場合はポートを選ぶ
• 接続の表示 : 待受側へ繋いできた相手を、RIGDOCKS Bridge のサーバータブの「接続中クライアント」に PARAKNOT (UDP) として表示し、OS のバナー通知で知らせる
• 通信ログ : PC 外との通信は、相手ごとのセッションの開始・終了をログに記録する。拒否した通信は 1 分ごとに件数をまとめて記録する
• ライセンス : RIGDOCKS 経由でライセンスを認証する。未認証のときは送受信を行わない

その他

• 表示言語 : 日本語 / 英語（OS の設定に従う）
• インストール : RIGDOCKS Bridge からパッケージでインストールする

API

実行中の PARAKNOT の状態を読み、設定を変更する API。ReaScript（Lua / Python）・rigcmd・RADNODZ から呼べる。いずれの経路でもRIGDOCKS 本体（常駐アプリ）の起動が必要。

インスタンス

• AZ_PARAKNOT_GetInstanceList : 動いているインスタンスの一覧を取得
• AZ_PARAKNOT_CountInstance : 動いているインスタンスの数を取得

画面の項目

画面で変更できる項目は、すべて取得と変更ができる。

• AZ_PARAKNOT_GetLabel : 表示名を取得
• AZ_PARAKNOT_SetLabel : 表示名を変更
• AZ_PARAKNOT_GetRole : モードを取得
• AZ_PARAKNOT_SetRole : モードを変更
• AZ_PARAKNOT_GetOutputMode : 送信時の変換を取得
• AZ_PARAKNOT_SetOutputMode : 送信時の変換を変更
• AZ_PARAKNOT_GetTargetPeer : 接続先を取得
• AZ_PARAKNOT_SetTargetPeer : 接続先を変更
• AZ_PARAKNOT_GetTargetPeerList : 接続先の選択肢を取得
• AZ_PARAKNOT_GetTargetPeerNameList : 接続先の名前リストを取得
• AZ_PARAKNOT_GetTargetPort : 接続先のポートを取得
• AZ_PARAKNOT_SetTargetPort : 接続先のポートを変更
• AZ_PARAKNOT_GetTargetPortList : 接続先のポートの選択肢を取得
• AZ_PARAKNOT_GetListenPort : 待受ポートを取得
• AZ_PARAKNOT_SetListenPort : 待受ポートを変更
• AZ_PARAKNOT_GetConnectEnabled : 接続トグル（接続側）を取得
• AZ_PARAKNOT_SetConnectEnabled : 接続トグル（接続側）を変更
• AZ_PARAKNOT_GetListenEnabled : 待受トグル（待受側）を取得
• AZ_PARAKNOT_SetListenEnabled : 待受トグル（待受側）を変更
• AZ_PARAKNOT_GetChannelPreset : チャンネルプリセットを取得
• AZ_PARAKNOT_SetChannelPreset : チャンネルプリセットを変更
• AZ_PARAKNOT_GetChannelPresetList : チャンネルプリセットの選択肢を取得
• AZ_PARAKNOT_GetMainChannelCount : メインチャンネル数を取得
• AZ_PARAKNOT_SetMainChannelCount : メインチャンネル数を変更
• AZ_PARAKNOT_GetSubChannelCount : サブチャンネル数を取得
• AZ_PARAKNOT_SetSubChannelCount : サブチャンネル数を変更
• AZ_PARAKNOT_GetChannelNames : チャンネル名を取得
• AZ_PARAKNOT_SetChannelName : チャンネル名を変更
• AZ_PARAKNOT_GetMicPreset : Ambisonics のマイクプリセットを取得
• AZ_PARAKNOT_SetMicPreset : Ambisonics のマイクプリセットを変更
• AZ_PARAKNOT_GetMicPresetList : Ambisonics のマイクプリセットの選択肢を取得
• AZ_PARAKNOT_GetAmbiDecode : Ambisonics のデコード先を取得
• AZ_PARAKNOT_SetAmbiDecode : Ambisonics のデコード先を変更
• AZ_PARAKNOT_GetAmbiDecodeList : Ambisonics のデコード先の選択肢を取得
• AZ_PARAKNOT_GetAmbiRotation : Ambisonics の向き（回転）を取得
• AZ_PARAKNOT_SetAmbiRotation : Ambisonics の向き（回転）を変更

音声のセッション

外部のアプリが PARAKNOT と直接音声をやり取りするための API。

• AZ_PARAKNOT_OpenInputSession : 受信(待受)の PARAKNOT へ音声を送るためのセッション（宛先ポートと暗号鍵）を発行
• AZ_PARAKNOT_OpenOutputSession : 配信中の PARAKNOT の音声を受け取るためのセッション（接続先ポートと暗号鍵）を発行

※ 制限事項

• Ambisonics は 1 次（FOA・4ch 入力）のみ対応。2 次以降（HOA）は未対応
• 相手の PC へ直接到達できる経路でのみ接続できる。ネットワーク越しの通信は未対応
• 16bit PCM で伝送する
• API の操作対象は同じ PC で動いている PARAKNOT のみ。インスタンスの識別子は PARAKNOT を起動し直すと変わる