25
パナソニックコミュニケーションズ(株) - Panasonic ネットワークカメラ 技術参考資料 ネットワークカメラ CGI 利用説明書 Ver. 2.3 2004 年 11 月 24 日 パナソニック コミュニケーションズ(株)

ネットワークカメラCGI利用説明書ssbu-t.psn-web.net/.../technic/ntwrkcam_cgi_intrfs1_v23.pdfパナソニックコミュニケーションズ(株) - 3 - 1.概要 ここでは、Panasonic

  • Upload
    others

  • View
    0

  • Download
    0

Embed Size (px)

Citation preview

Page 1: ネットワークカメラCGI利用説明書ssbu-t.psn-web.net/.../technic/ntwrkcam_cgi_intrfs1_v23.pdfパナソニックコミュニケーションズ(株) - 3 - 1.概要 ここでは、Panasonic

パナソニックコミュニケーションズ(株) - 1 -

Panasonic ネットワークカメラ

技術参考資料

ネットワークカメラ CGI 利用説明書

Ver. 2.3

2004 年 11 月 24 日

パナソニック コミュニケーションズ(株)

Page 2: ネットワークカメラCGI利用説明書ssbu-t.psn-web.net/.../technic/ntwrkcam_cgi_intrfs1_v23.pdfパナソニックコミュニケーションズ(株) - 3 - 1.概要 ここでは、Panasonic

パナソニックコミュニケーションズ(株) - 2 -

改版履歴

改版

Ver.

更新内容 日付

1.0 初版 2002 年 4 月 16 日

1.1 カメラのファームウエア Ver. 1.40 以降に対応し、パン・スキャン、

チルト・スキャン、ホーム・ポジション、プリセットの CGI コマンドを追加。 2002 年 9 月 12 日

2.0

公開 CGI コマンド追加

・nphMotionJpeg(動画データ取得)

・SnapShotJPEG(静止画データ取得)

既存 CGI へのインタフェース追加

・ImageViewer(タイトル表示 on/off 追加)

・nphControlCamera(ズーム指定、フォーカス指定追加)

2003 年 3 月 19 日

2.1

ファームウェアバージョン 1.61、及び 1.63 に対応

公開コマンド追加

・nphManipulateCamera(カメラへのパラメーター設定)

-ネットワーク設定

-カメラ名と時計設定

-管理者情報設定

-一般ユーザ情報設定

-画像転送設定

-カメラ設定

-外部出力設定

-保存画像の消去

・nphSecurityGeneralUserDelete(一般ユーザ情報削除)

・nphSecurityGeneralUserModify(一般ユーザ情報更新)

・nphRestart(再起動)

・nphPresetNameCheck(プリセットの登録、クリア)

・nphPanTiltControl(プリセット登録状況確認、プリセットの名前確認)

・nphReplayRecord(カメラバッファに保存した動画の取得)

・BufferingImage(バッファに保存した静止画の取得)

2003 年 5 月 31 日

2.2

ファームウェアバージョン 1.75 に対応

既存 CGI へのインタフェース追加

・nphManipulateCamera(カメラへのパラメーター設定)

-画像転送設定に TaskEnable パラメーター追加

-カメラ設定に Preset パラメーター追加

・nphControlCamera(カメラの制御)

-クリック&センタリング用パラメーター追加

2003 年 8 月 22 日

2.3

ファームウェアバージョン 1.8 に対応

既存 CGI へのインタフェース追加

・nphManipulateCamera(カメラへのパラメーター設定)

-ネットワーク設定に CameraConnectionType パラメーター追加

-画像転送(タイマー,アラーム)に TransferFtpLoginMode パラメーター追加

-カメラ設定に NightViewControl パラメーター追加

・nphReplayRecord(録画動画像取得)

-Type パラメーター追加

・BufferingImage(録画静止画像取得)

-Type パラメーター追加

2004 年 11 月 24 日

Page 3: ネットワークカメラCGI利用説明書ssbu-t.psn-web.net/.../technic/ntwrkcam_cgi_intrfs1_v23.pdfパナソニックコミュニケーションズ(株) - 3 - 1.概要 ここでは、Panasonic

パナソニックコミュニケーションズ(株) - 3 -

1.概要

ここでは、Panasonic ネットワークカメラ用CGIの仕様について説明致します。また、ライブ映像を Web ページに取り込む方

法についてはサンプルプログラムも用意しています。

Panasonic ネットワークカメラが内蔵している Web サーバーにこれから説明する CGI コマンドを発行することで、カメラの様々

な機能をプログラムから制御することができます。あなた自身の Web ページに、ライブ映像を取り込みたい場合や、カメラの

画像情報をご自身のプログラムで加工したい場合等に本ドキュメントを参考にしてください。

2.注意事項

当社は、本情報の使用によって生じたいかなる損害に対しても、一切の責任を負いません。

この情報は今後の製品のバージョンアップにより予告無しに変更の可能性があります。

サンプルプログラムはあくまでも参考例です。各プログラムに関してのサポートはできません。ご使用になる場合には、お客

様に HTML の知識が必要になります。

この情報は以下の製品に適応されます。

KX-HCM1、KX-HCM2、KX-HCM130、KX-HCM170、KX-HCM180、BB-HCM310

最大同時アクセス数は、カメラの仕様によりますので、以下の通りとなります。

KX-HCM1、KX-HCM2 :同時アクセス数最大 10

KX-HCM130、KX-HCM170、KX-HCM180、BB-HCM310 :同時アクセス数最大 30

最大同時アクセス数は、同時アクセスを保証するものではありません。上記数値以上のアクセスを制限するものであり、お

使いのネットワークの実環境によってはこの数以下になることもあります。

本ドキュメントは予告無しにアップデートされます。

最新版のドキュメント及びサンプルプログラムは、以下の WEB サイトをご覧ください。

http://panasonic.biz/netsys/netwkcam/index.html

Page 4: ネットワークカメラCGI利用説明書ssbu-t.psn-web.net/.../technic/ntwrkcam_cgi_intrfs1_v23.pdfパナソニックコミュニケーションズ(株) - 3 - 1.概要 ここでは、Panasonic

パナソニックコミュニケーションズ(株) - 4 -

3.コマンドリスト

3.1 ネットワーク設定

カメラのネットワーク設定を行う時に使用します。

NphManipulateCamera

Parameters Settings PAGE Network (固定) CameraBootpEnable Check (固定) CameraPort ポート番号 省略不可(通常は 80 を設定する) CameraDHCP DHCP 時のホスト名(省略可) CameraIP IP アドレス CameraNetmask ネットマスク CameraInternetFlag 0 (DHCP), 1 (Static)

DHCP 時 :CameraDHCP の設定が有効となる

Static 時 :CameraIP と CameraNetmask が必要 CameraGateway IP アドレス CameraDNS1 IP アドレス CameraDNS2 IP アドレス CameraDDNSEnable Check:DDNS 有効、未指定時:DDNS 無効 ※1

DDNS 有効とした場合は CameraEMail の入力は必須 CameraEMail DDNS 登録者の EMail アドレス CameraConnectionType 1 (自動)

2 (10 Mbps/半 2 重)

3 (10 Mbps/全 2 重)

4 (100 Mbps/半 2 重)

5 (100 Mbps/全 2 重)

CameraBandwidth 13107(0.1Mbps), 26214(0.2Mbps), 39321(0.3Mbps),

65536(0.5Mbps), 131072(1.0Mbps), 262144(2.0Mbps),

393216(3.0Mbps), 655360(5.0Mbps), 786432(Unlimited) Save ON(固定)

※1 パラメータ(CameraDDNSEnable)そのものが指定されてない場合に DDNS が無効となる。

言い換えれば DDNS を無効とする時は、このパラメータを記述する必要はない。

使用例

nphManipulateCamera?PAGE=Network&CameraBootpEnable=Check&CameraPort=80&CameraInternetFlag=1&Camer

aIP=192.168.0.250&CameraNetmask=255.255.255.0&CameraGateway=192.168.0.1&CameraDNS1=192.168.0.1&Ca

meraDNS2=202.238.95.24&CameraDDNSEnable=Check&CameraConnectionType=1&CameraBandwidth=65536&Save=O

N

Page 5: ネットワークカメラCGI利用説明書ssbu-t.psn-web.net/.../technic/ntwrkcam_cgi_intrfs1_v23.pdfパナソニックコミュニケーションズ(株) - 3 - 1.概要 ここでは、Panasonic

パナソニックコミュニケーションズ(株) - 5 -

3.2 カメラ名と時計設定

カメラの名称、及び時計の設定を行います。 nphManipulateCamera

Parameters Settings PAGE NameTime (固定) HeadingName カメラ名(1 - 15 文字) Year 0 - 99 (2000 年 - 2099 年を表す) Month 1 - 12 Day 1 - 31 Hour 0 - 23 Minute 0 - 59 NtpEnable Check:NTP 有効、未指定時=NTP 無効 ※1 NtpServer NTP サーバホスト名 or アドレス NtpMode -24 ~ 24 (-24=-12 時間,24=+12 時間)※2 Save ON (固定)

※1 パラメータ(NtpEnable)そのものを記述しなければ NTP は無効となる。

※2 0.5 時間単位での指定が可能。(例)24 = +12 時間、 23 = 11.5 時間 使用例

nphManipulateCamera?PAGE=NameTime&HeadingName=NetworkCamera&Year=2&Month=1&Day=1&Hour=0&Minute=0&

NtpEnable=Check&NtpServer=10.75.83.202&NtpMode=-24&Save=ON

3.3 管理者情報設定

管理者の情報を設定します。 nphManipulateCamera

Parameters Settings PAGE SecurityAdministrator (固定) AuthenticationEnable 0:認証無し , 1:設定画面のみ , 2:全ての画面 AdministratorID 管理者 ID (半角 4 ~ 15 文字) AdministratorPassword1 管理者パスワード1 (半角 4 ~ 15 文字) AdministratorPassword2 管理者パスワード2 (パスワード1と同じものを入れる) Save ON (固定)

使用例

nphManipulateCamera?PAGE=SecurityAdministrator&AuthenticationEnable=1&AdministratorID=Admin&Admin

istratorPassword1=mnger&AdministratorPassword2=mnger&Save=ON

Page 6: ネットワークカメラCGI利用説明書ssbu-t.psn-web.net/.../technic/ntwrkcam_cgi_intrfs1_v23.pdfパナソニックコミュニケーションズ(株) - 3 - 1.概要 ここでは、Panasonic

パナソニックコミュニケーションズ(株) - 6 -

3.4 一般ユーザー情報設定

nphManipulateCamera

Parameters Settings PAGE SecurityGeneralUser(固定) NewUserID ユーザーID (半角 4 ~ 15 文字) NewUserPassword1 ユーザーパスワード1 (半角 4 ~ 15 文字) NewUserPassword2 ユーザーパスワード2 (パスワード1と同じものを入れる) Save ON (固定)

使用例

nphManipulateCamera?PAGE=SecurityGeneralUser&NewUserID=xxxxx&NewUserPassword1=yyyyyy&NewUserPassw

ord2=yyyyy&Save=ON

3.5 一般ユーザー情報削除

nphSecurityGeneralUserDelete

Parameters Settings PAGE SecurityGeneralUserDelete (固定) USERNAME ユーザーID(半角 4 ~ 15 文字) OK OK (固定)

使用例

nphSecurityGeneralUserDelete?PAGE=SecurityGeneralUserDelete&USERNAME=xxxxx&OK=OK

3.6 一般ユーザー情報更新

nphSecurityGeneralUserModify

Parameters Settings PAGE SecurityGeneralUserModify(固定) USERNAME ユーザーID (半角 4 ~ 15 文字) NewUserPassword1 ユーザーパスワード (半角 4 ~ 15 文字) NewUserPassword2 ユーザーパスワード (パスワード1と同じものを入れる)

OK OK (固定)

使用例

nphSecurityGeneralUserModify?PAGE=SecurityGeneralUserModify&USERNAME=ppppp&NewUserPassword1=qqqqq

&NewUserPassword2=qqqqq&Save=ON

Page 7: ネットワークカメラCGI利用説明書ssbu-t.psn-web.net/.../technic/ntwrkcam_cgi_intrfs1_v23.pdfパナソニックコミュニケーションズ(株) - 3 - 1.概要 ここでは、Panasonic

パナソニックコミュニケーションズ(株) - 7 -

3.7 画像転送(無し)

画像転送無しの設定 nphManipulateCamera

Parameters Settings PAGE ImageTransferNon(固定)

TaskEnable on:動作許可 、 未指定時:動作禁止 ※1

ClearImage ON:保存画像を消去する、 未指定時:消去しない.※2

Save ON (固定)

※1 パラメータ(TaskEnable)そのものを記述しなければ動作禁止となる。 ※2 パラメータ(ClearImage)そのものを記述しなければ保存画像を消去しない。

使用例

nphManipulateCamera?PAGE=ImageTransferNon&TaskEnable=on&ClearImage=ON&Save=ON

3.8 画像転送(タイマー)

タイマーモードでの画像転送の設定を行う。 NphManipulateCamera

Parameters Settings PAGE ImageTransferTimer (固定)

TaskEnable on:動作許可 、 未指定時:動作禁止 ※1

PrimaryTimeMode 0 (指定時刻), 86400000 (常時)

PrimaryStartHour 時刻指定 1開始時刻

PrimaryStartMin ↑

PrimaryStartSec ↑

PrimaryStopHour 時刻指定 1終了時刻

PrimaryStopMin ↑

PrimaryStopSec ↑

PrimaryStartSun 動作曜日指定(日曜) ON:動作、未指定時:動作無し※2

PrimaryStartMon ↑ (月曜)

PrimaryStartTue ↑ (火曜)

PrimaryStartWed ↑ (水曜) PrimaryStartThu ↑ (木曜) PrimaryStartFri ↑ (金曜) PrimaryStartSat ↑ (土曜) SecondaryEnable ON:時刻指定2動作有り, 未指定時:動作無し※3 PrimaryResolution 0=640x480, 4=320x240, 8=160x120 PrimaryQuality 0=画質優先, 1=標準, 2=動き優先

Page 8: ネットワークカメラCGI利用説明書ssbu-t.psn-web.net/.../technic/ntwrkcam_cgi_intrfs1_v23.pdfパナソニックコミュニケーションズ(株) - 3 - 1.概要 ここでは、Panasonic

パナソニックコミュニケーションズ(株) - 8 -

Parameters Settings

PrimaryPostIntervalNum 指定時刻 1の画像保存間隔あたりの枚数 PrimaryPostIntervalPer 指定時刻 1の画像保存間隔の単位 1=秒, 60=分, 3600=時 SecondaryPostIntervalNum 指定時刻 2の画像保存間隔あたりの枚数 SecondaryPostIntervalPer 指定時刻 2の画像保存間隔の単位 1=秒, 60=分, 3600=時 TransferMode 画像転送モード 0=転送せずバッファ上に上書きしない, 16=転送

せずバッファ上に上書きする,32=FTP 転送, 48=メール転送 TransferFtpServer FTP サーバアドレス TransferFtpPortNo FTP ポート番号 TransferFtpLoginID FTP ログイン ID TransferFtpPassword FTP パスワード TransferFtpLoginMode 0=毎回,64=一回

TransferFtpFileName FTP ファイル名 TransferFtpFileNameMode FTP ファイル名生成モード,0=上書きする, 1=ファイル名に日時を

追加する TransferFtpPortMode FTP データ転送方式 0=パッシブモード, 16=アクティブモード TransferMailServer SMTP サーバアドレス TransferPopServer POP3 サーバアドレス TransferPopID POP3 ログイン ID TransferPopPassword POP3 パスワード TransferMailFrom 返信先メールアドレス TransferMailTo 宛先メールアドレス TransferMailSubject メール件名 TransferMailText メール本文 ClearImage ON 設定時:保存画像を消去する, 未指定時:消去しない.※4 Save ON (固定)

※1 パラメータ(TaskEnable)そのものを記述しなければ動作禁止となる。

※2 パラメータ(PrimaryStartSun)そのものを記述しなければ該等する曜日に動作しない。

※3 パラメータ(SecondaryEnable)そのものを記述しなければ時刻指定2は無効となる。

※4 パラメータ(ClearImage)そのものを記述しなければ保存画像を消去しない。

使用例

nphManipulateCamera?PAGE=ImageTransferTimer&TaskEnable=on&PrimaryTimeMode=86400000&PrimaryStartHo

ur=0&PrimaryStartMin=0&PrimaryStartSec=0&PrimaryStopHour=23&PrimaryStopMin=59&PrimaryStopSec=59&P

rimaryStartSun=ON&PrimaryStartMon=ON&PrimaryStartTue=ON&PrimaryStartWed=ON&PrimaryStartThu=ON&Pri

maryStartFri=ON&PrimaryStartSat=ON&SecondaryEnable=ON&PrimaryResolution=0&PrimaryQuality=0&Primar

yPostIntervalNum=1&PrimaryPostIntervalPer=1&SecondaryPostIntervalNum=1&SecondaryPostIntervalPer=1

&TransferMode=0&Save=ON

Page 9: ネットワークカメラCGI利用説明書ssbu-t.psn-web.net/.../technic/ntwrkcam_cgi_intrfs1_v23.pdfパナソニックコミュニケーションズ(株) - 3 - 1.概要 ここでは、Panasonic

パナソニックコミュニケーションズ(株) - 9 -

3.9 画像転送(アラーム)

アラームモードでの画像転送の設定を行う。 NphManipulateCamera

Parameters Settings PAGE ImageTransferAlarm (固定)

TaskEnable on:動作許可 、 未指定時:動作禁止 ※1

PrimaryTimeMode 0 (指定時刻), 86400000 (常時)

PrimaryStartHour 時刻指定 1開始時刻

PrimaryStartMin ↑

PrimaryStartSec ↑

PrimaryStopHour 時刻指定 1終了時刻

PrimaryStopMin ↑

PrimaryStopSec ↑

PrimaryStartSun 動作曜日指定(日曜)ON:動作、未指定時:動作無し ※2

PrimaryStartMon ↑ (月曜)

PrimaryStartTue ↑ (火曜)

PrimaryStartWed ↑ (水曜) PrimaryStartThu ↑ (木曜) PrimaryStartFri ↑ (金曜) PrimaryStartSat ↑ (土曜) PrimaryTrigger 時刻指定 1の検知する信号 3=立上り(開放),2=立下り(短絡)

SecondaryEnable ON:時刻指定2動作有り, 未設定時:無し ※3 SecondaryTrigger 時刻指定 2の検知する信号 3=立上り(開放),2=立下り(短絡)

PrimaryResolution 0=640x480, 4=320x240, 8=160x120 PrimaryQuality 0=画質優先, 1=標準, 2=動き優先 PrimaryPreEnable ON:検知前の画像を有効, 未設定時:無効 ※4 PrimaryPreIntervalNum 検知前の画像保存間隔あたりの枚数 PrimaryPreIntervalPer 検知前の画像保存間隔の単位 1=秒, 60=分, 3600=時 PrimaryPreNum 検知前画像の保存枚数 PrimaryPostIntervalNum 検知後の画像保存間隔あたりの枚数 PrimaryPostIntervalPer 検知後の画像保存間隔の単位 1=秒, 60=分, 3600=時 PrimaryPostNum 検知後画像の保存枚数 TransferMode 画像転送モード 0=転送せずバッファ上に上書きしない, 16=転送

せずバッファ上に上書きする, 32=FTP 転送, 48=メール転送 TransferFtpServer FTP サーバアドレス TransferFtpPortNo FTP ポート番号 TransferFtpLoginID FTP ログイン ID TransferFtpPassword FTP パスワード TransferFtpLoginMode 0=毎回,64=一回

TransferFtpFileName FTP ファイル名 TransferFtpFileNameMode FTP ファイル名生成モード 0=上書きする, 1=ファイル名に日時を

追加する TransferFtpPortMode FTP データ転送方式 0=パッシブモード, 16=アクティブモード TransferMailServer SMTP サーバアドレス TransferPopServer POP3 サーバアドレス TransferPopID POP3 ログイン ID

Page 10: ネットワークカメラCGI利用説明書ssbu-t.psn-web.net/.../technic/ntwrkcam_cgi_intrfs1_v23.pdfパナソニックコミュニケーションズ(株) - 3 - 1.概要 ここでは、Panasonic

パナソニックコミュニケーションズ(株) - 10 -

Parameters Settings

TransferPopPassword POP3 パスワード TransferMailFrom 返信先メールアドレス TransferMailTo 宛先メールアドレス TransferMailSubject メール件名 TransferMailText メール本文 MessageMode 検知時の通知指定 0=通知しない, 64=メール転送 MessageMailServer SMTP サーバアドレス MessagePopServer POP3 サーバアドレス MessagePopID POP3ID MessagePopPassword POP3 パスワード MessageMailFrom 返信先メールアドレス MessageMailTo 宛先メールアドレス MessageMailSubject メール件名 MessageMailText メール本文 ClearImage ON:保存画像を消去する, 未指定時:消去しない ※5 Save ON (固定)

※1 パラメータ(TaskEnable)そのものを記述しなければ動作禁止となる。

※2 パラメータ(PrimaryStartSun)そのものを記述しなければ該等する曜日に動作しない。

※3 パラメータ(SecondaryEnable)そのものを記述しなければ時刻指定2は無効となる。

※4 パラメータ(PrimaryPreEnable)そのものを記述しなければ検知前の画像は無効になる。

※5 パラメータ(ClearImage)そのものを記述しなければ保存画像を消去しない。

使用例

nphManipulateCamera?PAGE=ImageTransferAlarm&TaskEnable=on&PrimaryTimeMode=86400000&PrimaryStartHo

ur=0&PrimaryStartMin=0&PrimaryStartSec=0&PrimaryStopHour=23&PrimaryStopMin=59&PrimaryStopSec=59&P

rimaryStartSun=on&PrimaryStartMon=on&PrimaryStartTue=on&PrimaryStartWed=on&PrimaryStartThu=on&Pri

maryStartFri=on&PrimaryStartSat=on&PrimaryTrigger=3&SecondaryEnable=on&SecondaryTrigger=3&Primary

Resolution=0&PrimaryQuality=0&PrimaryPreIntervalNum=1&PrimaryPreIntervalPer=1&PrimaryPreNum=1&Pri

maryPostEnable=on&PrimaryPostIntervalNum=1&PrimaryPostIntervalPer=1&PrimaryPostNum=1&TransferMode

=0&Save=ON

Page 11: ネットワークカメラCGI利用説明書ssbu-t.psn-web.net/.../technic/ntwrkcam_cgi_intrfs1_v23.pdfパナソニックコミュニケーションズ(株) - 3 - 1.概要 ここでは、Panasonic

パナソニックコミュニケーションズ(株) - 11 -

3.10 カメラ設定

nphManipulateCamera

Parameters Settings PAGE CameraSetup(固定) WhiteBalance ホワイトバランス

0(自動),16(ホールド),32(屋内),48(白色蛍光灯),

64(昼白色蛍光灯),80(屋外)

PowLineFreq 電源周波数 60(60Hz), 50(50Hz) CameraBright 明るさ調整 0(許可), 2(禁止) NightViewControl カラーナイトビューモード 1(許可), 0(禁止)

CameraControl パン/チルト操作 0(許可), 1(禁止) Preset プリセットへの移動操作 0(許可), 32(禁止)

PresetControl プリセット登録操作 0(許可), 4(禁止) ZoomControl ズーム操作 0(許可), 8(禁止) FocusControl フォーカス操作 0(許可), 16(禁止) PanRangeMinus Pan 動作範囲の最小値 (1/100 度単位で指定 60 度=6000) PanHome Pan のホーム位置 PanRangePlus Pan 動作範囲の最大値 Layout 0(卓上), 1(天井) TiltRangeMinusTab Tilt 動作範囲の最小値(卓上) TiltHomeTab Tilt のホーム位置(卓上) TiltRangePlusTab Tilt 動作範囲の最大値(卓上) TiltRangeMinusCeil Tilt 動作範囲の最小値(天井) TiltHomeCeil Tilt のホーム位置(天井) TiltRangePlusCeil Tilt 動作範囲の最大値(天井) Save ON (固定)

使用例

nphManipulateCamera?PAGE=CameraSetup&WhiteBalance=0&PowLineFreq=50&CameraBright=0&NightViewContro

l=1&CameraControl=0&Preset=0&PresetControl=0&ZoomControl=0&FocusControl=0&PanRangeMinus=-17500&Pa

nHome=0&PanRangePlus=17500&Layout=0&TiltRangeMinusTab=-12000&TiltHomeTab=-9000&TiltRangePlusTab=0

&TiltRangeMinusCeil=0&TiltHomeCeil=9000&TiltRangePlusCeil=9000&Save=ON

<例:Tilt 範囲を全域(-120~+90)に設定する場合>

http://aaa.bb.ccc.d/nphManipulateCamera?PAGE=CameraSetup&WhiteBalance=0&PowLineFreq=50&CameraBrig

ht=0&NightViewControl=1&CameraControl=0&Preset=0&PresetControl=0&ZoomControl=0&FocusControl=0&Pan

RangeMinus=-17500&PanHome=0&PanRangePlus=17500&Layout=0&TiltRangeMinusTab=-12000&TiltHomeTab=-900

0&TiltRangePlusTab=9000&Save=ON

Page 12: ネットワークカメラCGI利用説明書ssbu-t.psn-web.net/.../technic/ntwrkcam_cgi_intrfs1_v23.pdfパナソニックコミュニケーションズ(株) - 3 - 1.概要 ここでは、Panasonic

パナソニックコミュニケーションズ(株) - 12 -

3.11 外部出力

nphManipulateCamera

Parameters Settings PAGE DigitalOutputControl (固定) DigitalOutput 0=開放, 1=短絡

Save ON (固定)

使用例

nphManipulateCamera?PAGE=DigitalOutputControl&DigitalOutput=0&Save=ON

3.12 再起動

nphRestart

Parameters Settings PAGE Restart(固定)

Restart OK

使用例

nphRestart?PAGE=Restart&Restart=OK

Page 13: ネットワークカメラCGI利用説明書ssbu-t.psn-web.net/.../technic/ntwrkcam_cgi_intrfs1_v23.pdfパナソニックコミュニケーションズ(株) - 3 - 1.概要 ここでは、Panasonic

パナソニックコミュニケーションズ(株) - 13 -

3.13 プリセットの登録

nphPresetNameCheck

Parameters Settings PresetName プリセット名(半角 15 文字、全角 7 文字)

Data プリセット番号( 1 - 8)

使用例

nphPresetNameCheck?PresetName=Test&Data=1

3.14 プリセットのクリア(削除)

nphPresetNameCheck

Parameters Settings Data プリセット番号( 1 - 8)

使用例

nphPresetNameCheck?Data=1

3.15 プリセットが登録されているかどうかの確認/プリセットの名前確認

nphPanTiltControl?Mode=Disp

で出力される HTML のデータから以下の内容を見て判断する.

(a).Preset 1 に登録がある場合.

- "PresetOFF01.gif"ファイルがある.

- ALT=xxxx が入っている.(xxxx はプリセット名)

<IMG SRC="image/PresetOFF01.gif" WIDTH=18 HEIGHT=18 BORDER=0 ALT="Test">

(b).Preset 1 に登録が無い場合.

- "PresetON01.gif"ファイルがある.

- ALT=""が入っている.

<IMG SRC="image/PresetON01.gif" WIDTH=18 HEIGHT=18 BORDER=0 ALT="">

Page 14: ネットワークカメラCGI利用説明書ssbu-t.psn-web.net/.../technic/ntwrkcam_cgi_intrfs1_v23.pdfパナソニックコミュニケーションズ(株) - 3 - 1.概要 ここでは、Panasonic

パナソニックコミュニケーションズ(株) - 14 -

3.16 録画動画像取得(MJPEG 形式取得)

カメラのバッファに蓄積した画像を動画として取得する。

nphReplayRecord

Parameters Settings Record 0(指定時刻 1 に録画した画像)、1(指定時刻 2 に録画した画像)、

2(一時保存画像) Type 0(アラームで録画した画像)、1(タイマーで録画した画像)、

2(一時保存画像)

使用例

nphReplayRecord?Record=0&Type=1 指定時刻 1 にタイマーで録画した動画像

nphReplayRecord?Record=1&Type=1 指定時刻 2 にタイマーで録画した動画像

nphReplayRecord?Record=0&Type=0 指定時刻 1 にアラームで録画した動画像

nphReplayRecord?Record=1&Type=0 指定時刻 2 にアラームで録画した動画像

nphReplayRecord?Record=2&Type=2 「一時保存開始」ボタンで録画した動画像

動画像の取得から表示の方法については 「3.20 動画像取得」の項を参考にして下さい。

3.17 録画静止画像取得(JPEG 形式)

カメラのバッファに蓄積した画像を静止画として取得する。 BufferingImage

Parameters Settings ImageAdr 0+画像 No.(指定時刻 1)、

65536+画像 No.(指定時刻 2)

131072+画像 No.(一時保存画像) Type 0(アラームで録画した画像)、1(タイマーで録画した画像)、

2(一時保存画像)

使用例

BufferingImage?ImageAdr=0&Type=1 指定時刻 1 にタイマーで録画した No.1 静止画像

BufferingImage?ImageAdr=65536&Type=1 指定時刻 2 にタイマーで録画した No.1 静止画像

BufferingImage?ImageAdr=0&Type=0 指定時刻 1 にアラームで録画した No.1 静止画像

BufferingImage?ImageAdr=65536&Type=0 指定時刻 2 にアラームで録画した No.1 静止画像

BufferingImage?ImageAdr=131072&Type=2 「一時保存開始」ボタンで録画した No.1 静止画像

Page 15: ネットワークカメラCGI利用説明書ssbu-t.psn-web.net/.../technic/ntwrkcam_cgi_intrfs1_v23.pdfパナソニックコミュニケーションズ(株) - 3 - 1.概要 ここでは、Panasonic

パナソニックコミュニケーションズ(株) - 15 -

3.18 保存画像の消去

カメラのバッファに蓄積した画像を消去する。 nphManipulateCamera

Parameters Settings PAGE ImageTransferNon(固定)

ClearImage OK

使用例

nphManipulateCamera?PAGE=ImageTransferNon&ClearImage=OK

Page 16: ネットワークカメラCGI利用説明書ssbu-t.psn-web.net/.../technic/ntwrkcam_cgi_intrfs1_v23.pdfパナソニックコミュニケーションズ(株) - 3 - 1.概要 ここでは、Panasonic

パナソニックコミュニケーションズ(株) - 16 -

3.19 画像表示

画像表示およびその指定には、ImageViewer を用います。ImageViewer のパラメータを設定することで、

動画表示指定/静止画表示指定、画像サイズ、動き重視/画質重視の別や静止画像の更新周期を指定できます。

ImageViewer

Parameters Settings

Mode Motion (動画像),

Refresh (静止画像)

Resolution 160x120,

320x240,

640x480

Quality Motion (動き優先),

Standard (標準),

Clarity (画質優先)

Interval 静止画像の更新周期を秒で指定

Title 1(タイトル有り)、0(タイトル無し) ※1

※1 タイトルは画像を表示するフレームの上部に表示されます。 このパラメータはファームウエア・バージョン

Ver1.61 以降で有効となります。これより古いバージョンのファームウエアをお使いの場合は、以下の

URL から最新版のファームウエアをダウンロードすることができます。

http://panasonic.biz/netsys/netwkcam/index.html

使用例

<動画像表示>

ImageViewer?Mode=Motion&Resolution=320x240&Quality=Standard&Title=1

<静止画表示 更新間隔:5秒>

ImageViewer?Mode=Refresh&Resolution=320x240&Quality=Standard&Interval=5&Title=1

※画像上にてマウスクリックした位置を画面中央に移動する機能(クリック&センタリング機能)

が入っています。

※HTML に記載する場合、以下のようにフレームを分割して配置して下さい。

以下を未設定の場合、マウスクリック時に新規 Window が開設されてしまいます。

ImageViewer フレーム(本フレーム)

Message フレーム(メッセージ表示用のダミーフレーム、サイズは0でも良い)

Page 17: ネットワークカメラCGI利用説明書ssbu-t.psn-web.net/.../technic/ntwrkcam_cgi_intrfs1_v23.pdfパナソニックコミュニケーションズ(株) - 3 - 1.概要 ここでは、Panasonic

パナソニックコミュニケーションズ(株) - 17 -

3.20 カメラ制御

カメラ制御(動き、明るさの制御)には、nphControlCamera を用います。左右・上下への移動、パンスキャン、ズーム、

明るさ指定、フォーカスの指定が可能です。パンチルト機構のないカメラ(KX-HCM2)は明るさ指定のみが有効となりま

す。

ズーム機能、オートフォーカス機能は、KX-HCM180 のみ有効となります。

nphControlCamera

Parameters Settings

Direction PanLeft (パンの左移動),

PanRight (パンの右移動)

TiltUp (チルトの上移動),

TiltDown (チルトの下移動)

Scan (パンスキャン) ※3

PanScan (パンスキャン) ※1、※3

TiltScan (チルトスキャン) ※1

HomePosition (ホーム・ポジション) ※1

Preset (プリセット) ※1、※2

Darker (画像を暗く),

DefaultBrightness (標準の明るさ),

Brighter (画像を明るく)

ZoomTele(ズームイン)

ZoomWide(ズームアウト)

FocusAuto(オートフォーカス) ※4

Direct(クリック&センタリング) ※5

※1…KX-HCM1では、ファームウエア・バージョン Ver1.40 以降で、このコマンドを使うことができます。

これより古いバージョンのファームウエアをお使いの場合は、以下の URL から最新版のファームウエアを

ダウンロードすることができます。

http://panasonic.biz/netsys/netwkcam/index.html

Page 18: ネットワークカメラCGI利用説明書ssbu-t.psn-web.net/.../technic/ntwrkcam_cgi_intrfs1_v23.pdfパナソニックコミュニケーションズ(株) - 3 - 1.概要 ここでは、Panasonic

パナソニックコミュニケーションズ(株) - 18 -

※2…Preset コマンドは動作指定に、以下のようなパラメータを使います。

Parameters Settings

PresetOperation Move (指定するプリセット・ポジションへの移動)

Data 1 (プリセット・ポジション①の指定)

2 (プリセット・ポジション②の指定)

3 (プリセット・ポジション③の指定)

4 (プリセット・ポジション④の指定)

5 (プリセット・ポジション⑤の指定)

6 (プリセット・ポジション⑥の指定)

7 (プリセット・ポジション⑦の指定)

8 (プリセット・ポジション⑧の指定)

※3…Scan と PanScan は、同じ動作(パン・スキャン)を行います。

※4… マニュアルでフォーカスを調整する場合は以下のパラメータを使います。

※5… クリック&センタリングと同じように動作させる場合は以下のパラメータを使います。

使用例(パン・レフト)

nphControlCamera?Direction=PanLeft

使用例(チルト・スキャン)

nphControlCamera?Direction=TiltScan

使用例(ホーム・ポジション)

nphControlCamera?Direction=HomePosition

Parameter Setting

Direction FocusNear(フォーカス:近づける)

FocusFar(フォーカス:遠ざける)

Dist 1(移動量:小)

2(移動量:大)

Parameter Setting

NewPosition.

x

表示画像の左上座標(x,y)を(0,0)とした時のクリック位置 x

座標

NewPosition.

y

表示画像の左上座標(x,y)を(0,0)とした時のクリック位置 y

座標

Width&Height 表示画像の解像度(Resolution)

Page 19: ネットワークカメラCGI利用説明書ssbu-t.psn-web.net/.../technic/ntwrkcam_cgi_intrfs1_v23.pdfパナソニックコミュニケーションズ(株) - 3 - 1.概要 ここでは、Panasonic

パナソニックコミュニケーションズ(株) - 19 -

使用例(プリセット・ポジション①への移動)

nphControlCamera?Direction=Preset&PresetOperation=Move&Data=1

使用例(画像を暗く)

nphControlCamera?Direction=Darker

使用例(マニュアルでのフォーカス調整)

nphControlCamera?Direction=FocusNear&Dist=1

使用例(クリック&センタリング)

nphControlCamera?Direction=Direct&NewPosition.x=100&NewPosition.y=100&Width=320&Height=240

Page 20: ネットワークカメラCGI利用説明書ssbu-t.psn-web.net/.../technic/ntwrkcam_cgi_intrfs1_v23.pdfパナソニックコミュニケーションズ(株) - 3 - 1.概要 ここでは、Panasonic

パナソニックコミュニケーションズ(株) - 20 -

3.21 動画像取得(MJPEG 形式取得:リアルタイム)

カメラから動画データを入手する時に使用します。入手したデータを随時蓄積すれば録画、

データを表示できるビューワーを用意すれば、リアルタイムでのモニタリングが可能となります。

※ご注意

画像データを取得してパソコンのハードディスクなどに保存される場合は、保存先のディスクの容量と

保存する画像データの容量を十分ご確認後、保存動作を実施してください。

保存容量が過大になると、パソコンの動作が不安定になるなど、著しく影響の出る場合があります。

nphMotionJpeg

Parameters Settings

Resolution 160x120,

320x240,

640x480

Quality Motion(動き優先)

Standard(標準)

Clarity(画質)

※画像表示方法

(1)受信開始

Connection(ソケット)を開設し、以下のコマンド文字列を HTTP ポートに送信します。

"GET

http://xxx.xxx.xxx.xxx:yy/nphMotionJpeg?Resolution=320x240&Quality=Standard

HTTP/1.0¥r¥n"

xxx.xxx.xxx.xxx :IP アドレスまたはドメイン名

yy :HTTP ポート番号(80 番は省略可能)

(2)データ受信

"HTTP/1.0 200 OK¥r¥n"

"Content-Type: multipart/x-mixed-replace; boundary=--myboundary..."

"...--myboundary.Content-type: image/jpeg..."

JPEG バイナリーデータ No.1(16 進

="FFD8................................FFD9")

"...--myboundary.Content-type: image/jpeg..."

JPEG バイナリーデータ No.2(16 進

="FFD8................................FFD9")

"...--myboundary.Content-type: image/jpeg..."

JPEG バイナリーデータ No.N(16 進

="FFD8................................FFD9")

※上記、"Content-type: image/jpeg"に続く FFD8 から "--myboundary"の直前の FFD9 迄が

1 枚分の JPEG データとなります。

Page 21: ネットワークカメラCGI利用説明書ssbu-t.psn-web.net/.../technic/ntwrkcam_cgi_intrfs1_v23.pdfパナソニックコミュニケーションズ(株) - 3 - 1.概要 ここでは、Panasonic

パナソニックコミュニケーションズ(株) - 21 -

(3)画像表示・保存

上記のデータから JPEG 画像部を取出して連続表示、あるいは保存します。

表示するためには上記データに対応したビューワを用意する必要があります。

(4)取得終了

Connection(ソケット)を切断する.

3.22 静止画像取得(JPEG 形式取得:リアルタイム)

カメラから静止画データを入手する時に使用します。

SnapshotJPEG

Parameters Settings

Resolution 160x120,

320x240,

640x480

Quality Motion(動き優先)

Standard(標準)

Clarity(画質)

使用例

SnapshotJPEG?Resolution=320x240&Quality=Standard

Page 22: ネットワークカメラCGI利用説明書ssbu-t.psn-web.net/.../technic/ntwrkcam_cgi_intrfs1_v23.pdfパナソニックコミュニケーションズ(株) - 3 - 1.概要 ここでは、Panasonic

パナソニックコミュニケーションズ(株) - 22 -

4.使用例参考

カメラの画像を Web ページに取り込むためのサンプル・プログラム<sample1.html>を紹介します。Web ページ上でのカメラ動

画像表示およびパンチルト制御を実現しています。3つのフレームから構成され、右側のフレーム”right”に動画像を表示し、

左上のフレーム”Control”にカメラのパンチルト制御パッドを配置しています。左下のフレーム”Message”には、カメラ制御時

のエラー・メッセージ等が表示されます。この”Message”というフレームは必ず用意するようにしてください。このフレームが

無いと、操作により別のウィンドウが開いてしまうことがあります。

また、パンチルト制御パッドの画像に “pad.gif” を使用しています。この画像は、カメラの画面に使用されていますので、そ

の画面から取得することができます。

サンプルのプログラム・ソースにはカメラの URL が指定されていませんので、そのままでは、”ページを表示できません”と

のエラー表示が出ます。プログラム・ソース中にお客様のお使いになりたいカメラの URL を御指定ください。

この Web ページを Microsoft Internet Explorer から初めてアクセスする時には、ActiveX コンポーネントをダウンロードするよ

うに求められます。

サンプルプログラム<sample1.html>のスクリーンショット

動画像表示フレーム”right”。

直接 ImageViewer を指定。

カメラのパンチルト制御パッド表示フレーム”Control”。

”control1.html”で記述。

フレーム”Message”。

”dummy.html”で記述。

Page 23: ネットワークカメラCGI利用説明書ssbu-t.psn-web.net/.../technic/ntwrkcam_cgi_intrfs1_v23.pdfパナソニックコミュニケーションズ(株) - 3 - 1.概要 ここでは、Panasonic

パナソニックコミュニケーションズ(株) - 23 -

サンプルプログラム<sample1.html>のソースコード

<!-- 本プログラムはあくまでも参考例です。このプログラムに関してのサポートはできません。 -->

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Frameset//EN">

<!-- sample1.html パン/チルト制御パッドと動画像表示フレームの組み合わせ -->

<HTML>

<HEAD>

<TITLE>Sample1</TITLE>

</HEAD>

<FRAMESET COLS="123,*" FRAMEBORDER=0 BORDER=0 FRAMESPACING=0>

<FRAMESET ROWS="175,*">

<!-- 左上フレーム:第一のカメラのパンチルト制御パッド表示フレーム -->

<FRAME BGCOLOR="#C4CEEF" SCROLLING=no SRC="frame/control1.html" NAME="Control">

<!-- 左下フレーム:パンチルト制御 CGI 応答用ダミーフレーム -->

<!-- 注意:このフレーム名"Message"は"frame/control1.html"内部で使用しています。-->

<FRAME BGCOLOR="#C4CEEF" SCROLLING=no SRC="frame/dummy.html" NAME="Message">

</FRAMESET>

<!-- 右フレーム:動画像表示フレーム -->

<!-- プログラム中の"xx.xx.xx.xxx"に第一のカメラの URL を入れてください。-->

<!-- "xx.xx.xx.xxx"が間違っているとページを表示できない旨のコメントが表示されます。 -->

<FRAME SRC="http://xx.xx.xx.xxx/ImageViewer?Mode=Motion&Resolution=320x240&Quality=Standard&Interval=10"

NAME="right">

<NOFRAMES>

<BODY>

<!-- フレーム未対応ブラウザのユーザーへの対応のための HTML を記載する -->

フレームに対応したブラウザでご覧ください。

</BODY>

</NOFRAMES>

</FRAMESET>

</HTML>

Page 24: ネットワークカメラCGI利用説明書ssbu-t.psn-web.net/.../technic/ntwrkcam_cgi_intrfs1_v23.pdfパナソニックコミュニケーションズ(株) - 3 - 1.概要 ここでは、Panasonic

パナソニックコミュニケーションズ(株) - 24 -

フレーム<control1.html>のソースコード

<!-- 本プログラムはあくまでも参考例です。このプログラムに関してのサポートはできません。 -->

<!-- 第一のカメラのパン/チルト制御用パッドフレーム control1.html -->

<html>

<head>

<title>

Control1 Frame

</title>

</head>

<body BGCOLOR="#C4CEEF">

<center>

<!-- 第一のカメラ用パン/チルト制御パッド表示 -->

<!-- プログラム中の"xx.xx.xx.xxx"に第一のカメラの URL を入れてください。-->

<table><tr><TD BGCOLOR="#C4CEEF" ALIGN=center>

<img src="http://xx.xx.xx.xxx/image/pad.gif" usemap="#pad" width=90 height=98

border=0>

</TD></tr></table>

<!-- パン/チルト制御パッドのクリッカブルマップ -->

<map name="pad">

<area shape="circle" coords="12,12 10"

href="http://xx.xx.xx.xxx/nphControlCamera?Direction=PanScan&Resolution=320x240&Quality=Standard&RPeriod=0&Siz

e=STD&PresetOperation=Move&Language=1" TARGET="Message" ALT="パンスキャン" TITLE="パンスキャン">

<area shape="circle" coords="78,12 10"

href="http://xx.xx.xx.xxx/nphControlCamera?Direction=TiltScan&Resolution=320x240&Quality=Standard&RPeriod=0&Si

ze=STD&PresetOperation=Move&Language=1" TARGET="Message" ALT="チルトスキャン" TITLE="チルトスキャン">

<area shape="circle" coords="45,33 10"

href="http://xx.xx.xx.xxx/nphControlCamera?Direction=TiltUp&Resolution=320x240&Quality=Standard&RPeriod=0&Size

=STD&PresetOperation=Move&Language=1" TARGET="Message" ALT="チルトアップ" TITLE="チルトアップ">

<area shape="circle" coords="20,58 10"

href="http://xx.xx.xx.xxx/nphControlCamera?Direction=PanLeft&Resolution=320x240&Quality=Standard&RPeriod=0&Siz

e=STD&PresetOperation=Move&Language=1" TARGET="Message" ALT="パンレフト" TITLE="パンレフト">

<area shape="circle" coords="45,58 10"

href="http://xx.xx.xx.xxx/nphControlCamera?Direction=HomePosition&Resolution=320x240&Quality=Standard&RPeriod=

0&Size=STD&PresetOperation=Move&Language=1" TARGET="Message" ALT="ホームポジション" TITLE="ホームポジション">

<area shape="circle" coords="70,58 10"

href="http://xx.xx.xx.xxx/nphControlCamera?Direction=PanRight&Resolution=320x240&Quality=Standard&RPeriod=0&Si

ze=STD&PresetOperation=Move&Language=1" TARGET="Message" ALT="パンライト" TITLE="パンライト">

<area shape="circle" coords="45,83 10"

href="http://xx.xx.xx.xxx/nphControlCamera?Direction=TiltDown&Resolution=320x240&Quality=Standard&RPeriod=0&Si

ze=STD&PresetOperation=Move&Language=1" TARGET="Message" ALT="チルトダウン" TITLE="チルトダウン">

</map>

</center>

</body>

</html>

Page 25: ネットワークカメラCGI利用説明書ssbu-t.psn-web.net/.../technic/ntwrkcam_cgi_intrfs1_v23.pdfパナソニックコミュニケーションズ(株) - 3 - 1.概要 ここでは、Panasonic

パナソニックコミュニケーションズ(株) - 25 -

フレーム<dummy.html>のソースコード

<!-- 本プログラムはあくまでも参考例です。このプログラムに関してのサポートはできません。 -->

<html>

<head>

<title>

Dummy Frame

</title>

</head>

<body BGCOLOR="#C4CEEF">

</body>

</html>