SDK同梱ドキュメント：AdamAppDevelopmentManualForIpro_Vx_xx.pdf
目次
...
| Table of Contents | ||||
|---|---|---|---|---|
|
...
はじめに
この章では、AdamApp を i-pro 上で実行（インストール、スタート、ストップ、アンインストールする など）する方法について説明します。
また、このチュートリアルでは、SDKのインストールディレクトリを${SDK_DIR}として記載します。
1.1.i-pro で AdamApps を実行する
この節では、AdamApp の実行方法について説明します。
1.1.1.Adam 実行環境に関する配慮事項
Adam 実行環境を動作させる際、下記のことに配慮してください。
⚫ 配慮事項
市販されている i-PRO カメラでは、暗号化された AdamApp のみインストール可能です。しかし、AdamAppSDK では、暗号化された AdamApp の生成はできません。
i-PRO 株式会社に依頼して、AdamApp を暗号化した後、インストールを行ってください。開発ライセンス(4.2 節)を用いることで、暗号化されていない AdamApp を特定の i-PRO カメラへインストールすることが可能です。
1.1.2.Adam 実行環境のセットアップ方法
i-pro 上には、Adam 実行環境が既にインストールされているため、新規の設定は必要ありません。
1.1.3.Adam実行環境の起動方法
i-pro では、電源 on 時に、Adam 実行環境と、HTTP サーバが実行されます。このため、開始のために、新規の作業はありません。
1.1.4.AdamApps の操作方法: インストール、開始、停止、アンインストールなど
i-pro での AdamApp を操作する方法は、Adam Control Extension を用いる方法と、i-pro カメラの操作画面を利用する方法の 2 種類の方法があります。1.1.4.1 では、Adam Control Extension を用いる方法を説明し、1.1.4.2では、i-proの操作画面を利用する方法について説明します。
1.1.4.1.方法 1: Adam Control Extensionを使用する
この節では、Adam 実行環境が動いているマシンに対し、AdamApp の操作（インストール、スタート、ストップ、アンインストールなど）する手順について説明します。
(1) ブラウザを起動（Chrome 6.0 以降）
AdamApp の操作するための UI は、Chrome 用の拡張機能として用意されています。まず、Chromeブラウザを立ち上げてください。
(2) Adam Control Extension を起動
下記のように、Chrome 中のアドレスバーの右横にあるボタンを押し、Adam Control Extensionを選択してください。
...
(3) Adam実行環境と接続
...
| Info |
|---|
カメラにログインしている状態でなければカメラに接続できません。 事前にURLにカメラのIPアドレスを入力するなどして、カメラにログインした状態で 「Connect」ボタンを押してください。 |
(4) AdamAppをインストールする
インストールする AdamApp を選択します。
...
インストールを終了する
...
(5) AdamApp の起動
...
(6) AdamApp の停止
...
(7) AdamApp のアップデート
...
(8) AdamApp のアンインストール
...
1.1.4.2.方法 2: i-pro カメラの操作ページを使用する
(1) ブラウザを起動（Internet Explorer 7 以降）
i-pro に、AdamApp をインストールするために、ブラウザを起動します。なお、i-pro の操作画面は、Internet Explorer7 以降に対応しています。
(2) 拡張ソフトウェアの操作ページにアクセス
AdamApp を i-pro にインストールするために、拡張ソフトウェアの操作ページにアクセスします。
<http://<IP Address of i-pro>/admin/setup_ext_software.html
アクセスに成功すると、下記の操作ページが表示されます。
...
(3) AdamApp をインストールする
インストールしたい AdamApp を指定して、Execute ボタンを押すと、インストールが開始されます。
...
インストールが成功すると、下記の画面になります。
...
(4) AdamApp の起動
...
AdamApp を開始します。i-pro の操作ページでは、「拡張ソフトウェア」の「動作スケジュール」画面にて、「動作内容」を「On」に設定することで開始することができます。また、AdamAppSDK では、Adam Control Extension、及び、AdamApp 開始用シェルスクリプト startAdamApp.sh を用意しています。
Adam Control Extension を利用する場合は、6.1.4.1 節★を参照してください。
startAdamApp.sh シェルスクリプトを利用する場合は、下記のようにシェルスクリプトを実行してください。なお、startAdamApp.sh スクリプトの先頭に、監視カメラの情報を設定するマクロ変数があります。これらのマクロ変数に、監視カメラの IP アドレス(IPRO_ADDR マクロ)、及び、ユーザ名(IPRO_USER マクロ)とパスワード(IPRO_PASSWD マクロ)を設定したのち、このスクリプトを実行してください。この章では、i-PRO カメラに AdamApps をインストール、起動、停止、またはアンインストールする方法について説明します。
| Info |
|---|
市販の i-PRO カメラには暗号化された AdamApp のみインストールできます。 暗号化されていないアプリは、カメラの開発ライセンスをリクエストしたカメラにのみインストールできます。 暗号化または開発ライセンスをリクエストするには、こちらにアクセスしてください。 |
カメラにアプリをインストールするにはさまざまな方法があります
カメラ 1 台の場合は、カメラ Web ブラウザーを使用するのが簡単です。
開発者ツール「Adam コントロール拡張機能」も簡単な方法ですが、これは開発者専用です。
i-PRO 構成ツール (iCT) は、複数のカメラに同時にアプリをインストールまたは更新する場合に便利です。
パートナーのシステムから WEB API 経由でアプリを制御
1. カメラ Web ブラウザー
...
(1) Web ブラウザ http://<ip> を使用してカメラにアクセスします。
(2) 設定ページ[Ext software] - [Software mng.].に移動します。
(3)ファイルを選択して実行します。
...
(4)インストールされたアプリはアンインストールボタンとともに表示されます。
...
(5) AdamAppの起動と停止
インストールされたアプリは、「Operation sched.」の設定に従って自動的に起動および停止します。 デフォルトでは常に実行されています。
...
さらに、AdamApp SDK には、AdamApp を起動するためのスクリプト「startAdamApp.sh」と、AdamApp を停止するためのスクリプト「stopAdamApp.sh」が用意されています。
「startAdamApp.sh シェルスクリプト」を使用する場合は、以下のようにシェルスクリプトを実行する必要があります。 なお、starAdamApp.sh スクリプトの先頭には監視カメラの情報を指定するマクロ変数があります。 実行前に、これらの変数に IP アドレス (IPRO_ADDR)、ユーザー名 (IPRO_USER)、パスワード (IPRO_PASSWD) を設定してください。
| Code Block |
|---|
$ cd ${SDK_DIR}/tool/adamapp
$ ./startAdamApp <AdamApp’s FuncID (in decimal)>
##### AdamApp Information #####
FUNC_ID=257
INSTALL_ID=0DAF95AC
##### start application result #####
{} |
(5) AdamApp の停止
AdamApp を停止します。i-pro の操作ページでは、「拡張ソフトウェア」の「動作スケジュール」画面にて、「動作内容」を「Off」に設定することで開始することができます。また、AdamAppSDK では、Adam Control Extension、及び、AdamApp 停止用シェルスクリプト stopAdamApp.sh を用意しています。
Adam Control Extension を利用する場合は、1.1.4.1 節★を参照してください。
stopAdamApp.sh シェルスクリプトを利用する場合は、下記のようにシェルスクリプトを実行してください。なお、stopAdamApp.sh スクリプトの先頭に、監視カメラの情報を設定するマクロ変数があります。これらのマクロ変数に、監視カメラの IP アドレス(IPRO_ADDR マクロ)、及び、ユーザ名(IPRO_USER マクロ)とパスワード(IPRO_PASSWD マクロ)を設定したのち、このスクリプトを実行してください。
| Code Block |
|---|
$ cd ${SDK_DIR}/tool/adamapp
$ ./stopAdamApp <AdamApp’s FuncID (in decimal)>
##### AdamApp Information #####
FUNC_ID=257
INSTALL_ID=0DAF95AC
##### stop application result #####
{} |
(6) AdamApp のアンインストール
AdamApp のアンインストールは、i-pro の操作ページを使って行います。拡張ソフトウェアの操作ページにアクセスします。
<http://<IP Address of i-pro>/admin/setup_ext_software.html
アクセスに成功すると、下記の操作ページが表示されます。 この画面中の「Uninstall」ボタンを押すと、アンインストールが始まります。
...
アンインストールが完了すると、下記の画面になります。
...
1.1.5.Adam 実行環境の停止方法
...
※${SDK_DIR} はSDKインストールディレクトリです。
2. Adam Control Extension（Google Chrome拡張ツール）
...
2.1 Adam Control Extensionインストール方法
Adam Operation UI の Google Chrome 用 Extension をインストールします。
Chrome の「メニューボタン→その他のツール→拡張機能」を選択して、拡張機能ページを表示してください。
...
ファイルマネージャで、<iPRO_CAMERA_SDK_Vx_xxx>/toolを開き、AdamControlExtensionフォル ダを拡張機能ページ上にドラックアンドドロップをしてください。
...
インストールできない場合は、拡張機能ページの「デベロッパーモード」を有効にしてください。
...
| Info |
|---|
ADAM OPERATION UIに接続する際にAuthエラーが表示される場合は下記FAQを確認してください。 |
2.2 使用方法
(1) Google Chrome（バージョン6.0以降）を開き、カメラ（http://<ip>）にアクセスして事前にログインします。
(2) Chromeのアドレスバー右側にある「拡張機能」ボタンをクリックし、「Adam application manager for i-pro」をクリックします。
...
...
(3) Adam実行環境に接続する
カメラのIPアドレスを入力し、「Connect」ボタンをクリックします。 接続できない場合は、事前に手順（1）のカメラへのアクセスを行ってください。
| Info |
|---|
同一ブラウザで手順(1)のカメラのアクセスを行っていないと、「Connect」ボタン押下しても接続できません。 |
...
.
...
(4) AdamAppのインストール
インストールする AdamApp を選択します。
...
...
インストールを完了します。
...
(5) AdamAppを起動する
...
...
(6) AdamAppを停止する
...
...
(7) AdamApp をアップデートする
...
...
...
(8) AdamAppをアンインストールする
...
...
3. i-PRO Configuration Tool
...
i-PRO設定ツール（iCT）/ i-PRO設定プラグイン | i-PRO Products から i-PRO 設定ツールをダウンロードしてください。 基本的な使用方法はマニュアルを参照してください。
(1) ネットワーク上のカメラを検出します
(2) メニュー [Ext. Software Management]- [App. installation/Update] から、アプリをインストールするカメラを選択し、右側の [Partner Applications] を選択して、アプリ ファイルを選択して開始します。
...
4. パートナーシステムからWEB API経由でアプリを制御
...
カメラファームウェアは、アプリのインストール「/cgi-bin/adam_install.cgi」、アップデート「/cgi-bin/addon_update」、アンインストール「/cgi-bin/addon_uninstall」用の CGI をサポートしています。詳細については、CGI ドキュメントを参照してください。
開発資料 | i-PRO Products
ADAM WEB API は、Adam Control Extension (Google Chrome 拡張ツール) でも使用される開始および停止 API を提供します。詳細については、SDK ドキュメント「AdamWebAPI_Specification_Vx_xx.pdf」を参照してください。