メインコンテンツまでスキップ

APIを使った操作

デコーダーは API を使用して、遠隔から映像切替や任意の OSD 表示を行うことが可能です。

1. 映像切替（単画面／4画面）​

HTTP API（GET）で映像表示モードの切替が可能です。

API フォーマット​

http://<デコーダIP>/httpapi/WriteParam?action=writeparam&VOUT_DISPLAY_HDMI=<値>

値の一覧​

値内容
0チャンネル1 単画面
1チャンネル2 単画面
2チャンネル3 単画面
3チャンネル4 単画面
4ローテーション表示
54画面（Quad）表示

例：4画面表示に切替​

http://192.168.1.100/httpapi/WriteParam?action=writeparam&VOUT_DISPLAY_HDMI=5

例：チャンネル1の単画面に切替​

http://192.168.1.100/httpapi/WriteParam?action=writeparam&VOUT_DISPLAY_HDMI=0

認証について​

HTTP 認証（Digest 認証）が必要です。
ブラウザに直接入力する場合は、以下の形式で指定してください。

http://admin:password@192.168.1.100/httpapi/WriteParam?action=writeparam&VOUT_DISPLAY_HDMI=0

2. カメラ名の文字重畳（OSD 表示）​

HTTP API（GET）で HDMI 出力上にカメラ名等のテキストを重畳表示できます。

  • 各チャンネル（0〜3）にそれぞれ 8 個のテキストエントリを設定可能
  • 設定は本体に保存され、再起動後も維持されます

パラメータ一覧​

パラメータ名内容
ETC_DECUSEROSDENABLE{エントリ}_CH{チャンネル}有効／無効（0 or 1）
ETC_DECUSEROSDSTRING{エントリ}_CH{チャンネル}表示文字列（最大20文字）
ETC_DECUSEROSDX{エントリ}_CH{チャンネル}X座標（0〜1000, パーミル）
ETC_DECUSEROSDY{エントリ}_CH{チャンネル}Y座標（0〜1000, パーミル）
ETC_DECUSEROSDFONTSIZE{エントリ}_CH{チャンネル}フォントサイズ（12〜84）
ETC_DECUSEROSDCOLOR{エントリ}_CH{チャンネル}色（0=白, 5=赤, 6=緑, 7=青 等）
  • エントリ：0〜7
  • チャンネル：0〜3

例：チャンネル0に「CAMERA-01」を映像下部中央に白文字で表示​

http://192.168.1.100/httpapi/WriteParam?action=writeparam&
ETC_DECUSEROSDENABLE0_CH0=1&
ETC_DECUSEROSDSTRING0_CH0=CAMERA-01&
ETC_DECUSEROSDX0_CH0=500&
ETC_DECUSEROSDY0_CH0=950&
ETC_DECUSEROSDFONTSIZE0_CH0=36&
ETC_DECUSEROSDCOLOR0_CH0=0

例：チャンネル1に「CAMERA-02」を表示​

http://192.168.1.100/httpapi/WriteParam?action=writeparam&
ETC_DECUSEROSDENABLE0_CH1=1&
ETC_DECUSEROSDSTRING0_CH1=CAMERA-02&
ETC_DECUSEROSDX0_CH1=500&
ETC_DECUSEROSDY0_CH1=950&
ETC_DECUSEROSDFONTSIZE0_CH1=36&
ETC_DECUSEROSDCOLOR0_CH1=0

例：OSD表示を無効化​

http://192.168.1.100/httpapi/WriteParam?action=writeparam&
ETC_DECUSEROSDENABLE0_CH0=0

文字表示位置について​

  • X, Y 座標は 0〜1000 のパーミル値で指定します
  • 映像下部中央の場合は X=500, Y=950 が目安です
  • 座標基準：
    • X=0 → 左端
    • X=1000 → 右端
    • Y=0 → 上端
    • Y=1000 → 下端

備考​

  • 映像切替と同時に OSD テキストを API で変更することも可能です
  • HTTP 認証（Digest 認証）が必要です