...
Table of contents
...
| Table of Contents | ||||
|---|---|---|---|---|
|
はじめに
この章では、AdamApp を i-pro 上で実行（インストール、スタート、ストップ、アンインストールする など）する方法について説明します。
また、このチュートリアルでは、SDKのインストールディレクトリを${SDK_DIR}として記載します。
i-proでAdamAppsを実行する
この節では、AdamApp の実行方法について説明します。
Adam 実行環境に関する配慮事項
Adam 実行環境を動作させる際、下記のことに配慮してください。
⚫ 配慮事項
市販されている i-PRO カメラでは、暗号化された AdamApp のみインストール可能です。しかし、AdamAppSDK では、暗号化された AdamApp の生成はできません。
i-PRO 株式会社に依頼して、AdamApp を暗号化した後、インストールを行ってください。開発ライセンス(4.2 節)を用いることで、暗号化されていない AdamApp を特定の i-PRO カメラへインストールすることが可能です。
Adam 実行環境のセットアップ方法
i-pro 上には、Adam 実行環境が既にインストールされているため、新規の設定は必要ありません。
Adam実行環境の起動方法
i-pro では、電源 on 時に、Adam 実行環境と、HTTP サーバが実行されます。このため、開始のために、新規の作業はありません。
AdamApps の操作方法: インストール、開始、停止、アンインストールなど
i-pro での AdamApp を操作する方法は、Adam Control Extension を用いる方法と、i-pro カメラの操作画面を利用する方法の 2 種類の方法があります。Adam Control Extension を用いる方法を説明と、i-proの操作画面を利用する方法について説明します。
方法 1: Adam Control Extensionを使用する
この節では、Adam 実行環境が動いているマシンに対し、AdamApp の操作（インストール、スタート、ストップ、アンインストールなど）する手順について説明します。
(1) ブラウザを起動（Chrome 6.0 以降）
AdamApp の操作するための UI は、Chrome 用の拡張機能として用意されています。まず、Chromeブラウザを立ち上げてください。
(2) Adam Control Extension を起動
Chrome 中のアドレスバーの右横にある「拡張機能」ボタンを押し「Adam application manager for i-pro」を押してください。
...
(3) Adam実行環境と接続
TargetにカメラのIPアドレスを入力し、Connectボタンを押下します。
...
ただし、カメラにログインしている状態でなければカメラに接続できません。
接続できない場合は下記のようにブラウザURLにカメラのIPアドレス(例：192.168.0.10)を入力するなどして、カメラにログインした状態で「Connect」ボタンを押してください。
...
(4) AdamAppをインストールする
インストールする AdamApp を選択します。
...
インストールを終了する
...
(5) AdamApp の起動
...
(6) AdamApp の停止
...
(7) AdamApp のアップデート
...
(8) AdamApp のアンインストール
...
方法 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 の起動
...
Introduction
...
This chapter shows how to install, start, stop or uninstall AdamApps on i-PRO camera.
| Info |
|---|
Only encrypted AdamApp can be installed into i-PRO camera on the market. Non-encrypted app can be installed only for cameras that you have requested development license for the camera. Please visit here to request encryption or development license. |
There are various methods to install app to camera
Camera web browser is easy way for one camera.
Developer tool “Adam control extension” is also easy way, but this is only for developer.
i-PRO Configuration Tool (iCT) is useful when user wants to install or update app for multiple cameras at the same time.
Control app via WEB API from partner’s system
1. Camera web browser
...
(1) Access the camera using web browser, http://<ip>.
(2) Move to configuration page [Ext software] - [Software mng.].
(3)Choose File and Execute
...
(4)Installed app will be appeared with uninstall button.
...
(5) Start and stop AdamApp
Installed app will start and stop automatically according to “Operation sched.” configuration.
Default is always running.
...
In addition, AdamApp SDK provides script “startAdamApp.sh” to start AdamApp and “stopAdamApp.sh” to stop it.
A shell script must be executed as indicated below when using “startAdamApp.sh shell script. Note that there are macro variables at the beginning of starAdamApp.sh script that specify the information of the surveillance camera. Please set up these variables with the IP address (IPRO_ADDR), the username (IPRO_USER) and the password (IPRO_PASSWD) before the execution.
| Code Block |
|---|
$ cd ${SDK_DIR}/tool/adamapp
$ ./startAdamApp <AdamApp’s FuncID (in decimal)>
##### AdamApp Information #####
FUNC_ID=257
INSTALL_ID=0DAF95AC
##### start application result #####
{} |
...
AdamApp を停止します。i-pro の操作ページでは、「拡張ソフトウェア」の「動作スケジュール」画面にて、「動作内容」を「Off」に設定することで開始することができます。また、AdamAppSDK では、Adam Control Extension、及び、AdamApp 停止用シェルスクリプト stopAdamApp.sh を用意しています。
Adam Control Extension を利用する場合は、i-proでAdamAppsを実行するの「方法 1: Adam Control Extensionを使用する」を参照してください。
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 ##### {} |
* ${SDK_DIR} is the installation directory.
2. Adam Control Extension (Google Chrome extension tool)
...
2.1 How to install
Install the Adam Operation UI extension for Google Chrome.
Click “menu” -> “More tools” -> “Extensions”, and open “Extensions” page.
...
Open /tool folder using file manager, then drag and drop “AdamControlExtension” folder on Extensions page.
...
Enable “Developer mode” on Extensions page if you could not install the extension.
...
| Info |
|---|
If an Auth error is displayed when connecting to the ADAM OPERATION UI, please check the FAQ below. |
2.2 How to use
(1) Open Google Chrome (version 6.0 or later), access to camera(http://<ip>) and login in advance.
(2) Click the "Extensions" button on the right side of the address bar in Chrome and click "Adam application manager for i-pro".
...
(3) Connect with Adam execution environment
Enter the IP address of the camera and click the Connect button.
When you cannot connect, please do step (1), access to the camera in advance.
| Info |
|---|
If you have not accessed the camera using the same browser as in step (1), you will not be able to connect even if you press the "Connect" button. |
...
(4) Install AdamApp
Select an AdamApp to install.
...
Finish installation.
...
(5) Start AdamApp
...
(6) AdamApp のアンインストール
AdamApp のアンインストールは、i-pro の操作ページを使って行います。拡張ソフトウェアの操作ページにアクセスします。
<http://<IP Address of i-pro>/admin/setup_ext_software.html
アクセスに成功すると、下記の操作ページが表示されます。 この画面中の「Uninstall」ボタンを押すと、アンインストールが始まります。
...
アンインストールが完了すると、下記の画面になります。
...
Adam 実行環境の停止方法
i-pro では、電源 off すると、Adam 実行環境と、HTTP サーバが終了します。このため、終了のために、新規の作業はありません。Stop AdamApp
...
(7) Update AdamApp
...
(8) Uninstall AdamApp
...
3. i-PRO Configuration Tool
...
Download from i-PRO Configuration Tool from https://i-pro.com/products%5fand%5fsolutions/en/surveillance/learning-and-support/tools/ict .
Please refer to the manual for basic usage.
(1)Detect cameras on the network
(2)From the menu [Ext. Software Management]- [App. installation/Update], select cameras that you want to install app, select Partner Applications on right side, select app file and Start.
...
4. Control app via WEB API from partner’s system
...
Camera firmware support CGI for app installation “/cgi-bin/adam_install.cgi”, updating “/cgi-bin/addon_update“, and uninstallation ”/cgi-bin/addon_uninstall“. Refer to CGI documentation for the detail.
ADAM WEB API provides start and stop API that are also used in Adam Control Extension (Google Chrome extension tool). Refer to SDK documentation “AdamWebAPI_Specification_Vx_xx.pdf“ for the detail.