HTTP API（Application Programming Interface) はｶﾒﾗとのｿﾌﾄｳｪｱ・ｲﾝﾀｰﾌｪｰｽで中央の管理ｼｽﾃﾑへのｶﾒﾗの組み込みを容易にするものです。ｲﾝﾀｰﾌｪｰｽは2つのCGIスクリプトで構成されており、ﾊﾟﾗﾒｰﾀと値をともなうHTTPｺﾏﾝﾄﾞです。その記述内容によって、 Setup のｻﾌﾞﾒﾆｭｰ設定内容の変更や、ｶﾒﾗ動作の実行が可能です。
HTTPｺﾏﾝﾄﾞ http://192.168.11.104/control/controlを使用して、 設定メニューの設定変更が可能です。
Qカメラモデルの統合で、これより HTTP APIでも vPTZ機能 (バーチャル・パン/チルト/ズーム) を提供します。機能に関しては、特定のヘルプページに記述があり、以下のリンクを使用して開くことができます：
click.cgi：インターフェースは vPTZ機能に制限されたアクセスを提供します。
rotorcgi：インターフェースは vPTZ機能にフルアクセスを提供します。
control?list§ion=vptzcontrol：control では、 vptzcontrol セクションの記述通り、いくつかの vPTZ機能へのアクセスを提供しますsection.
HTTPｺﾏﾝﾄﾞ http://192.168.11.104/control/rcontrolを使用してｶﾒﾗの機能を実行する事ができます。
ｺﾝﾌｨｸﾞﾚｰｼｮﾝの セーブおよびリストア に関する動作は admin ｱｸｾｽﾚﾍﾞﾙのﾕｰｻﾞによってのみ実行可能です。この場合、 rcontrol スクリプトの呼び出しに、別のＨＴＴＰｺﾏﾝﾄﾞが必要になります。それは：
http://192.168.11.104/admin/rcontrol
Control コマンドで list 命令を使用する場合、 ?を使ってコマンドから命令を区別する必要があります：
http://192.168.11.104/control/control?list
ﾊﾟﾗﾒｰﾀを付けて命令を実行するには、命令とﾊﾟﾗﾒｰﾀを区別するためにｱﾝﾊﾟｰｻﾝﾄﾞ記号 &で区切ってください。パラメータの値は = マークで区別されます。
http://192.168.11.104/control/control?list§ion=actions
複数のﾊﾟﾗﾒｰﾀを使用する場合は、各ﾊﾟﾗﾒｰﾀをｱﾝﾊﾟｰｻﾝﾄﾞ記号 &で区切ります：
http://192.168.11.104/control/rcontrol?action=ledson&time=5
いくつかのパラメータについては両方のﾚﾝｽﾞを指定するために2個の値を入力してください。これらのパラメータは 2つ のデフォルト値 (例： 0 0)を持って表示されます。httpコマンドでは、これらの値は + マークを使用して区別する必要があります：
http://192.168.11.104/control/control?set§ion=general&sharpen=0+0
コマンドに 1つ以上の改行文字を使用する場合 (例：複数のビデオモーションウィンドウを定義する場合など)、改行文字は CGI 置換文字列 %0Aを使用して置き換える必要があります。
http://192.168.11.104/control/control?set§ion=general&coverimage_area=0,540,380,200,200,2%0A1,320,100,100,150,2
CGI フォーマットの文字列を表示するには (改行文字、空欄、ウムラウト...など)、 URL-符号化された 文字を入力します。このためには、表示する 16進数値文字による % マークを入力します。以下のテーブルでは、頻度の高い共通文字がリストされています。
|
文字 |
URL-符号化 |
文字 |
URL-符号化 |
文字 |
URL-符号化 |
|
(改行) |
|
(空欄) |
|
% |
|
|
& |
|
+ |
|
= |
|
|
? |
|
© |
|
® |
|
|
ß |
|
ä |
|
Ä |
|
|
ö |
|
Ö |
|
ü |
|
|
Ü |
|
Ç |
|
à |
|
|
á |
|
â |
|
æ |
|
|
ç |
|
è |
|
é |
|
|
ê |
|
ë |
|
î |
|
|
ï |
|
ô |
|
ù |
|
|
ú |
|
ù |
|
û |
|
詳細は ja.wikipedia.org/wiki/パーセントエンコーディングを参照してください。
特定のパラメータにカラー値を指定することができます。これらの値は、特定色である赤、緑、青 (TGB) 値の 16進値に対応しています。それぞれの 2文字は、 00 は最低値 (色なし)を FF は最高値 (フルカラー)を意味します。色は相加的にミックスされており、 0x000000 は黒色、 0XFFFFFF は白色になります。
|
カラー名 |
16進記号 |
色 |
カラー名 |
16進記号 |
色 |
|---|---|---|---|---|---|
|
黒 |
|
マロン |
|
||
|
濃い緑 |
|
オリーブ |
|
||
|
マリン |
|
パープル |
|
||
|
ティール |
|
濃いグレー |
|
||
|
明るいグレー |
|
赤色 |
|
||
|
緑色 |
|
黄色 |
|
||
|
青色 |
|
マゼンタ |
|
||
|
シアン |
|
白 |
|
はじめに、どの命令を実行すべきかカメラに指示が必要です。
|
ｲﾝｽﾄﾗｸｼｮﾝ |
説明 |
|---|---|
|
set |
アクセス設定の書き込み。この命令は設定の変更に使用します。 http://192.168.11.104/control/control?set&<parameter>=<value>[&<parameter>=<value>] |
|
ｒｅａｄ |
アクセス設定の読みだし。この命令は設定内容の問い合わせに使用します。 http://192.168.11.104/control/control?read&<parameter>[&<parameter>] |
|
ｌｉｓｔ |
list ｲﾝｽﾄﾗｸｼｮﾝは、ｺﾝﾌｨｸﾞﾚｰｼｮﾝﾌｧｲﾙの中で変更のあったｾｸｼｮﾝをﾘｽﾄｱｯﾌﾟします。 特定ｾｸｼｮﾝのﾊﾟﾗﾒｰﾀを修正するには、記述の最後部に section=sectionname を追加します。 例：
このコマンドは、現在の値の読み込みを許可、利用可能なオプションの取得および他のアプリケーションでユーザインターフェースのテキスト取得方法を提供します。 |
|
ｆａｃｔｏｒｙ |
factory ｲﾝｽﾄﾗｸｼｮﾝはｾｸｼｮﾝのﾊﾟﾗﾒｰﾀを工場出荷時の設定値にﾘｾｯﾄします。使用時は追加ﾊﾟﾗﾒｰﾀとしてｾｸｼｮﾝ名、 section=sectionname が必要です。 http://192.168.11.104/control/control?factory§ion=<section name> |
|
リストア |
リストア でｾｸｼｮﾝのﾊﾟﾗﾒｰﾀをﾌﾗｯｼｭﾒﾓﾘに保存しておいた設定値に戻します。使用時は追加ﾊﾟﾗﾒｰﾀとしてｾｸｼｮﾝ名、 section=<sectionname> が必要です。 http://192.168.11.104/control/control?restore§ion=<section name> |
プロファイルは、ひとつの値に複数設定を保存します：
<profile designator>=<name>[:<parameter>=<value>].
同一の <profile designators> で複数のプロファイルは共存できます。プロファイルは read および set コマンドを使用して適せつな編集ができないため、以下のコマンドを利用してください：
|
ｲﾝｽﾄﾗｸｼｮﾝ |
説明 |
|---|---|
|
read_profile |
プロファイルの読み込み。 http://192.168.11.104/control/control?read_profile=<profile designator>:<name> |
|
delete_profile |
プロファイルの削除 http://192.168.11.104/control/control?delete_profile=<profile designator>:<name> |
|
set_profile |
プロファイルの書き込み。 http://192.168.11.104/control/control?set_profile=<profile designator>:<name>&<parameter>=<value>[&<parameter>=<value>] |
|
add_profile |
プロファイルの追加。 http://192.168.11.104/control/control?add_profile=<profile designator>:<name>&<parameter>=<value>[&<parameter>=<value>] |
また、いくつかのプロファイルにはさらに多くのパラメータがあり、前にアンダースコア文字があることにより確認されます。
|
ﾊﾟﾗﾒｰﾀ |
説明 |
|---|---|
|
_profilename |
このプロファイルには本当の名前があります。 |
|
_profilestate |
現時点では、プロファイル値の状態は空欄 ( |
セクションでは、 control コマンドを使用してリモート制御可能なすべてのダイアログに応答する以下のテーブルが表示されます。以下にリストされたリンクをクリックして、応答するセクションに移動します。
グループアクセスコントロールリスト の API 権限 への公共アクセスができる場合、もしくは ユーザ名 に権限がある場合場合にのみ、フレーム内容は表示されます。
インターフェースは vPTZ機能に制限されたアクセスを提供します。このインターフェースが提供するコマンドリストの取得には、 list コマンドを使用してください：
http://192.168.11.104/control/click.cgi?list
help コマンドは、詳細情報や各コマンドの使用例を戻します。
http://192.168.11.104/control/click.cgi?help
query コマンドは、現在の vPTZ設定に関する情報を戻します。
このインターフェースは、vPTZ機能へのフルアクセスを提供します。 help コマンドは、各コマンドの使用に関する詳細情報を戻します。
ｽｸﾘﾌﾟﾄの最初の値は実行されるｱｸｼｮﾝの名前です。ｱｸｼｮﾝに応じて追加ﾊﾟﾗﾒｰﾀを準備してください必要なﾊﾟﾗﾒｰﾀとｵﾌﾟｼｮﾝとしてのﾊﾟﾗﾒｰﾀがあります。
本フレームに関する内容は、 グループアクセスコントロールリスト の API 権限に公的アクセスができる場合、または ユーザ名 が権限を所持している場合にのみ表示されます。
カメラのこのページは英語のみです。
rcontrol コマンドの全オプションを確認するためには、ブラウザのアドレスバーに list 命令を入力してください。
| en, jp |