外部 SDK / API

Middle Control は TCP API を公開しており、外部のデバイスやソフトウェアから Middle Control にコマンドを送信したり、カメラや gimbal のライブデータを読み取ったりできます。

この機能が役立つ場面：

カスタムデバイスやスクリプトからプリセットのトリガー、録画の開始/停止、gimbal の操作を行いたい
Middle Control を放送自動化ワークフローに組み込みたい
Middle Control と直接通信するカスタムコントロールパネル（ハードウェアまたはソフトウェア）を構築したい

ポート変更 — API はポート 11584 に移行しました

この API はかつてポート 11581 でドキュメント化されていました。そのポートは Middle Remote (Glue) 接続と共有されており、Middle Remote が Direct モード（macOS のデフォルト）の場合は拒否されます。統合を 11581 で構築していた場合は、ポートを 11584 に変更するだけで対応できます。コマンドとフィードバックフレームは同一です。（この外部 API は macOS の機能です。Windows では Companion ポート 11580 と Glue / Remote ポート 11581 を使用してください。）

注記

APC-R ユニットと直接通信する SDK はありません。すべてのコマンドは、コンピューター上で動作している Middle Control アプリを経由します。

🔌 接続

デバイスまたはソフトウェアは、Middle Control が動作しているコンピューターにプレーンテキストの TCP コマンドを送信します。各コマンドは短い文字列（例：CAM3、PRESET1、P500）で、改行文字で終端されます — 1 行につき 1 コマンドです。

TCP 接続の詳細

ホスト : Middle Control が動作しているコンピューターの IP アドレス （同一マシン上でソフトウェアを動作させる場合は 127.0.0.1 を使用）

ポート : 11584

終端文字 : \n（LF または CRLF）

知っておくべきこと：

コマンドは大文字・小文字を区別します — このページに記載されている通りに送信してください。
API はファイア・アンド・フォーゲット方式です。不正なコマンドや未知のコマンドは無視されます（エラー応答はありません）。状態の確認にはライブフィードバックを使用してください。
統合が接続されると、Middle Control の左サイドバーの Controllers の下に External API エントリーが表示されます — 接続が開いている間は表示され続けます。

ターミナルからのクイックテスト — カメラ 1 を選択してプリセット 1 をトリガーする：

printf 'CAM1\nPRESET1\n' | nc <MIDDLE_CONTROL_IP> 11584

🎯 カメラの選択とターゲット指定

このページのすべてのコマンドはカメラ ID（1〜99）に対して動作します。指定方法は 2 通りあります：

CAMx でカメラを選択する — 以降のコマンドがそのカメラに対して動作し、フィードバックフレームにも反映されます。Middle Control のサイドバーでクリックするのと同様に、選択中のカメラが切り替わります。
コマンドの末尾に @Cx を追加して1 つのコマンドをターゲット指定する — 選択状態を変えずにカメラ x にコマンドを送ります。

コマンド	説明
`CAM3`	カメラ/gimbal 3 を選択する — 以降のコマンドがそれに対して動作する
`REC_START@C2`	カメラ 2 の録画を開始する（選択状態は変わらない）
`AUTOFOCUS@C5`	カメラ 5 のオートフォーカスをトリガーする（選択状態は変わらない）
`P500@C1`	カメラ 1 にパンコマンドを送る（選択状態は変わらない）

ヒント

ターゲット指定コマンドを使うと、マルチカメラ操作が簡単になります — REC_START@C1、REC_START@C2、REC_START@C3 を素早く連続送信して、カメラ 1、2、3 の録画を同時に開始できます。

🕹️ Gimbal & PTZ コントロール

可変スピード

指定したスピードで軸を駆動します — その軸は 0 を送るまで動き続けます：

コマンド	説明
`Pxx`	パンスピード。`xx` は -2048〜+2048（INT16）
`Txx`	チルトスピード。`xx` は -2048〜+2048（INT16）
`Rxx`	ロールスピード。`xx` は -2048〜+2048（INT16）
`Zxx`	ズームスピード。`xx` は -2048〜+2048（INT16）

停止するには 0 を送信してください

P500 はパンを開始し、P0 はそれを停止します。安全機構として、軸が動いている状態で TCP 接続が切断された場合、Middle Control はその軸を自動的に停止します。

ボタンコマンドとプリセットで使用されるスピード設定：

コマンド	説明
`PTSxx`	パン/チルトスピード設定。`xx` は 1〜100（INT8）
`ZSxx`	ズームスピード設定。`xx` は 1〜100（INT8）

絶対位置

1 つのコマンドで gimbal を正確な位置に移動します。フレームフォーマットは次のとおりです：

aGLOB;aPxx;aTxx;aRxx;aZxx;ss

パーツ	説明
`aGLOB`	フレームの先頭に必ず記述する
`aPxx`	絶対パン位置。1/10 度単位（INT16）
`aTxx`	絶対チルト位置。1/10 度単位（INT16）
`aRxx`	絶対ロール位置。1/10 度単位（INT16）
`aZxx`	絶対ズーム位置。0〜4096（INT16）
`ss`	トランジション時間（秒）

例：パン 20°、ロール 2°、チルト 7.5°、ズーム中間値まで 5 秒かけて移動する：

aGLOB;aP200;aR20;aT75;aZ2500;5

現在のトランジションスピードを使って、単一軸だけを送ることもできます：

コマンド	説明
`aPxx` / `aTxx` / `aRxx`	1 軸を `xx` に移動する（1/10 度単位）
`aZxx`	ズームを `xx` に移動する（0〜4096）

ボタンとユーティリティ

ボタン押下と同様に動作します：

コマンド	説明
`PAN_L` / `PAN_R`	gimbal を左/右にパンする
`TILT_U` / `TILT_D`	gimbal を上/下にチルトする
`ROLL_L` / `ROLL_R`	gimbal を左/右にロールする

停止コマンドが必要です

上記の各移動コマンドの後、70ms 以上の遅延を置いてから対応する停止コマンドを送信する必要があります：

移動	停止コマンド
`PAN_L` / `PAN_R`	`PAN_IDLE`
`TILT_U` / `TILT_D`	`TILT_IDLE`
`ROLL_L` / `ROLL_R`	`ROLL_IDLE`

停止コマンドの前に接続が切断された場合、Middle Control は自動的に移動を停止します。

コマンド	説明
`ZOOM+` / `ZOOM-`	ズームをステップ単位で拡大/縮小する
`SPEED+` / `SPEED-`	パン/チルトスピードを増加/減少させる
`ZSPEED+` / `ZSPEED-`	ズームスピードを増加/減少させる

Gimbal ユーティリティ：

コマンド	説明
`RECENTER`	gimbal を中心に戻す
`ACTIVETRACK`	アクティブトラックを有効化/無効化する
`GIMBALSLEEP` / `GIMBALWAKE`	gimbal をスリープ/ウェイクする
`GIMBALAUTOCALIB`	Gimbal オートキャリブレーション（Autotune）を開始する
`MOTORAUTOCALIB`	フォーカスモーターのオートキャリブレーションを開始する

🎥 カメラコントロール

利用可能なコマンドはカメラのブランドと接続方法によって異なります（一部のコマンドは Sony 専用、一部は ATEM リンクが必要）。

絶対値

カメラの値を直接設定します：

コマンド	説明
`aFxx`	フォーカス。`xx` は 0.0〜1.0（FLOAT）
`aIxx`	アイリス。`xx` = F 値（FLOAT） — 最も近いサポート済み F ストップ（おおよそ f/1.2〜f/22）にスナップされる
`aWBxx`	ホワイトバランス。`xx` は 2500〜10000 ケルビン（INT16 — 整数のみ）
`aTINTxx`	ティント。`xx` は -100〜+100（INT8）
`aISOxx`	ISO / ゲイン（dB）。`xx` は -12〜+36（INT8）
`aSHUTxx`	シャッター。`xx` = 分母（INT16 — 例：`aSHUT50` は 1/50 秒）
`NDxx` / `NDCLEAR`	ND フィルター。`xx` = 分母：`ND4` = 1/4、`ND16`、`ND64`、`ND256`、`ND1024`（内蔵 ND を持つすべてのブランドの標準ラダー）；Sony の可変 ND 機では 2〜4096 の任意の値も使用可能；`NDCLEAR`（または `ND0`）でフィルターを解除する。フィードバックフレームでは `aND` として読み返される

ATEM スイッチャー経由で制御されているカメラ（カラーコレクター値）：

コマンド	説明
`aSATxx`	サチュレーション。`xx` は 0〜100
`aCONTxx`	コントラスト。`xx` は 0〜100
`aBLACKLEVxx`	ブラックレベル（リフト輝度）。`xx` は -2.0〜+2.0
`aMIDLEVxx`	ミッドレベル（ガンマ輝度）。`xx` は -4.0〜+4.0
`aWHITELEVxx`	ホワイトレベル（ゲイン輝度）。`xx` は 0〜16.0

ケルビン/ティントの代わりにレッド/ブルーゲインを使用する VISCA カメラ：

コマンド	説明
`aRGAINxx`	レッドゲイン。`xx` は 0〜255
`aBGAINxx`	ブルーゲイン。`xx` は 0〜255

ステップとトグル

1 コマンドにつき 1 インクリメント：

コマンド	説明
`FOCUS+` / `FOCUS-`	フォーカスを近く/遠くに動かす — アプリのフォーカスボタンと同様の動作：1 コマンド = 微小な 1 ステップ；連続コマンド（ボタン長押し、エンコーダーの素早い回転）はランプアップし、最後のコマンドから 200ms 後に停止する
`FOCUS+0.002` / `FOCUS-0.002`	レンズ移動量の指定した割合だけフォーカスを近く/遠くに動かす（ランプなし）（`0 < size ≤ 1`；`FOCUS+0.01` は 4.0.4 以前の単体コマンドのステップ量）
`IRIS+` / `IRIS-`	アイリスを増加/減少させる
`WB+` / `WB-`	ホワイトバランスを増加/減少させる
`ISO+` / `ISO-`	ISO を増加/減少させる
`TINT+` / `TINT-`	ティントを増加/減少させる
`SHUTTER+` / `SHUTTER-`	シャッターを増加/減少させる
`ND+` / `ND-`	ND フィルターを増加/減少させる
`SHARP+` / `SHARP-`	シャープネスを増加/減少させる
`CONT+` / `CONT-`	コントラストを増加/減少させる（ATEM）
`SAT+` / `SAT-`	サチュレーションを増加/減少させる（ATEM）
`BLEV+` / `BLEV-`	ブラックレベルを増加/減少させる（ATEM）

ボタン長押し中のフォーカス操作

押し続けるタイプのボタン（Stream Deck やコントローラーキー）では、押したときにスタートコマンド、離したときにストップコマンドを送信します — フォーカスはマウスでアプリ独自のフォーカスボタンを押し続けたときと同様に動作します：最初に微小なステップ、その後ランプアップします。

コマンド	説明
`FOCUS_IN` / `FOCUS_OUT`	フォーカスを近く/遠くへの移動を開始する（`FOCUS+` / `FOCUS-` と同方向）
`FOCUS_IDLE`	停止する

FOCUS_IDLE の前に接続が切断された場合、Middle Control は自動的に移動を停止します；また、停止コマンドなしに 10 秒が経過した場合も長押し状態が解除されます。3 つのコマンドはいずれも @C<n> カメラサフィックスに対応しています。

オートモードとモニタリングのトグル：

コマンド	説明
`AUTOFOCUS`	オートフォーカスをトリガーする
`AUTOIRIS`	オートアイリスをトリガーする
`AUTOSHUTTER`	オートシャッターをトグルする
`AUTOGAIN`	オートゲイン / ISO をトグルする
`AUTOWB`	オートホワイトバランスをトグルする
`COLORBARS`	カラーバーを表示する
`ZEBRA`	ゼブラガイドを表示する
`FALSECOLORS`	フォルスカラーガイドを表示する
`FOCUSPEAKING`	フォーカスピーキングをトグルする
`STATUSVIEW`	カメラの HDMI 出力にステータスビューを表示する
`DIGITAL_ZOOM`	デジタルズームをトグルする（Sony）
`RESETCCU`	CCU / カラーコレクター値をリセットする

メニューナビゲーション（Sony）

コマンド	説明
`BTN_MENU`	メニューボタンを押す
`BTN_OK`	OK ボタンを押す
`BTN_LEFT` / `BTN_RIGHT` / `BTN_UP` / `BTN_DOWN`	矢印ボタンを押す
`MULTISEL_LEFT` / `MULTISEL_RIGHT` / `MULTISEL_UP` / `MULTISEL_DOWN`	マルチセレクターを動かす
`MULTISEL_PRESS`	マルチセレクターを押す
`CUSTOM_C1` … `CUSTOM_C6`	カスタム機能 C1 … C6 をトリガーする

録画

コマンド	説明
`REC_START`	録画を開始する（現在選択中のカメラ）
`REC_STOP`	録画を停止する（現在選択中のカメラ）
`REC_START_ALL`	すべてのカメラで録画を開始する
`REC_STOP_ALL`	すべてのカメラで録画を停止する

フィードバックフレームは、現在録画中のカメラを REC_LIST[…] に一覧表示します。

📌 プリセット

コマンド	説明
`PRESET1` … `PRESET12`	現在選択中のカメラのプリセット 1 … 12 をトリガーする
`PRESET1@C5` … `PRESET12@C5`	カメラ 5 のプリセット 1 … 12 をトリガーする（Middle Control のプリセット 5.1〜5.12）
`SPRESET1@C5` … `SPRESET12@C5`	カメラ 5 のプリセット 1 … 12 を保存する（Middle Control のプリセット 5.1〜5.12）

プリセット再生のコントロール：

コマンド	説明
`STOPPRESET`	実行中のプリセット移動を停止する（特定のカメラを停止するには `@Cx` を追加）
`PRES_Dxx`	プリセットのトランジション時間を設定する。`xx` は秒単位
`PRES_Exx`	プリセットのトランジションイージングを設定する。`xx` は 0（リニア）〜100 — `PRES_D` と同様にすべてのカメラに共通の値（APC-R ファームウェア 2.0 以降）

🔁 オートメーション

Automations ページのオートメーションを開始、停止、調整します。すべてのコマンドは @Cx ターゲット指定に対応しています。

Camera Shake

コマンド	説明
`SHAKE-START` / `SHAKE-STOP`	カメラシェイクを開始/停止する
`SHAKE-SPEEDxx`	シェイクスピード。`xx` は 1〜100
`SHAKE-AMPLxx`	シェイク振幅。`xx` は 1〜100

Zoom Loop

コマンド	説明
`ZLOOP-START` / `ZLOOP-STOP`	ズームループを開始/停止する
`ZLOOP-SPEEDxx`	ズームスピード。`xx` は 1〜100
`ZLOOP-DURATIONxx`	ズーム移動時間。`xx` は秒単位（0.1〜60）
`ZLOOP-RESTDURATIONxx`	ループ間の停止時間。`xx` は秒単位（0.1〜15）

Presets Sequence

コマンド	説明
`PRESETSEQ-START` / `PRESETSEQ-STOP`	プリセットシーケンスを開始/停止する
`PRESETSEQ-BANKx`	アクティブなシーケンスバンクを選択する。`x` は 1〜7
`PRESETSEQ-SPEEDxx`	シーケンスのトランジションスピード。`xx` は秒単位（0.1〜15）
`PRESETSEQ-RESTDURATIONxx`	各プリセットでの停止時間。`xx` は秒単位（0.1〜15）

フィードバックフレームは、選択中のカメラの各オートメーションのライブ状態を報告します：SHAKE_RUN、ZLOOP_RUN、PRESETSEQ_RUN（実行中は 1）、および PRESETSEQ_BANK（アクティブなバンク）。

🖥️ Live View & Multi View

Middle Control が動作しているコンピューター上のモニタリングウィンドウを開閉します：

コマンド	説明
`LIVEVIEW_OPEN` / `LIVEVIEW_CLOSE`	現在選択中のカメラの Live View ウィンドウを開く/閉じる（先に `CAMx` で選択してください）
`MULTIVIEW_OPEN` / `MULTIVIEW_CLOSE`	Multi View ウィンドウを開く/閉じる（Middle Control Pro — ライセンスがない場合は無視されます）

📡 ライブフィードバック

Middle Control は同じ TCP 接続を通じて、約毎秒 4 回ライブステータスフレームをプッシュします。フレームは現在選択中のカメラの状態を反映します。これにより、gimbal とカメラの現在の状態を読み取ることができます — フィードバックディスプレイやリアクティブなワークフローの構築に役立ちます。

注記

カメラ値のフィードバックは、Middle Control が ATEM スイッチャーまたは有線 LAN 経由でカメラに接続されている場合に利用できます。APC-R がカメラにリンクされている場合は Gimbal の角度も含まれます。

TCP Feedback Frame — example
{CAM5;REC1;AF0;DZOOM0;aWB5600;aF0.45;aI6.5;aUI5.4;aTINT10;aISO12;aSHUT1/50;aSAT50;aCONT50;aBLACKLEV0.4;SHAKE_RUN0;ZLOOP_RUN0;PRESETSEQ_RUN1;BRANG_RUN0;PRESETSEQ_BANK1;aPAN523;aTILT124;aROLL890;aZOOM3992;PTS85;ZS24;PRES_D8.0;PRES_ACTIVE0;PRES_E50;REC_LIST[5];CAM_CON_LIST[1,2,5];APCR_CON_LIST[5]}

各フレームは \n で終わる 1 行です：{CAM<id> の後に ; 区切りのトークンが続き、} で閉じられます。トークンの順序：

トークン	意味
`CAM`	選択中のカメラ ID
`REC` / `AF` / `DZOOM`	選択中のカメラの録画 / オートフォーカス / デジタルズーム（`1` または `0`）
`aWB`	ホワイトバランス（ケルビン）
`aF`	フォーカス位置（0.0〜1.0）
`aI` / `aUI`	アイリス F 値（ストップロック / アンロック）
`aTINT`	ティント（符号付き）
`aISO`	ゲイン（dB）
`aSHUT`	シャッター（分母、例：`50` または `1/50`）
`aND`	ND フィルターの分母（`4` = 1/4、`16`、`64` …）；フィルターがクリアの場合またはカメラに ND がない場合は `-`
`aSAT` / `aCONT` / `aBLACKLEV`	サチュレーション、コントラスト、ブラックレベル（ATEM リンクカメラ）
`SHAKE_RUN` / `ZLOOP_RUN` / `PRESETSEQ_RUN`	選択中のカメラでそのオートメーションが実行中は `1`、それ以外は `0`（`BRANG_RUN` は予約済み、常に `0`）
`PRESETSEQ_BANK`	アクティブなプリセットシーケンスバンク（1〜7）
`aPAN` / `aTILT` / `aROLL`	Gimbal の角度（1/10 度単位）（APC-R リンク時）
`aZOOM`	ズームモーター位置（0〜4096）（APC-R リンク時）
`PTS` / `ZS`	現在のパン/チルトスピードとズームスピードの設定値
`PRES_D`	プリセットのトランジション時間（秒）
`PRES_ACTIVE`	プリセット移動の実行中は `1`、それ以外は `0`
`PRES_E`	プリセットのトランジションイージング（0〜100）。APC-R ファームウェア 2.0 以降がない場合は `-`
`REC_LIST[…]`	現在録画中のカメラ ID
`CAM_CON_LIST[…]`	現在接続中のカメラ ID
`APCR_CON_LIST[…]`	APC-R gimbal が接続されているカメラ ID

位置ではなくトークン名でパースしてください

カメラのブランドと接続方法によっては、フレームから一部のトークンが省略される場合があります。また、利用できない値は -（ダッシュ）として送信されます — パーサーがすべてのトークンが常に存在し数値であると仮定せず、両方のケースを処理できるようにしてください。

🔌 接続​

🎯 カメラの選択とターゲット指定​

🕹️ Gimbal & PTZ コントロール​

可変スピード​

絶対位置​

ボタンとユーティリティ​

🎥 カメラコントロール​

絶対値​

ステップとトグル​

ボタン長押し中のフォーカス操作​

メニューナビゲーション（Sony）​

録画​

📌 プリセット​

🔁 オートメーション​

🖥️ Live View & Multi View​

📡 ライブフィードバック​