インテグレーテッドカメラ インターフェース仕様書

Supplement for Web Control
対象機種
AW-UE4 (Ver.2.05)
AW-HE20/AW-UE20 (Ver.1.27)

パナソニック エンターテインメント & コミュニケーション株式会社

目次
1.はじめに ..................................................................................................................................................... 2
2. 映像配信に関する CGI 一覧 ...................................................................................................................... 3
2.1. 配信ユーザー管理 .............................................................................................................................. 3
2.2. JPEG 系画像配信 ............................................................................................................................... 4
2.3. MJPEG での画像配信シーケンス ......................................................................................................... 7
2.4. JPEG 画像 1shot での画像配信シーケンス .......................................................................................... 8
3. 各種設定に関する CGI 一覧 ...................................................................................................................... 93.1. 基本設定 ............................................................................................................................................ 93.2. Video over IP 設定 ........................................................................................................................... 10
3.3. ネットワーク設定 ............................................................................................................................... 11
3.4. 再起動 ............................................................................................................................................. 12
4. 各種情報の取得に関する CGI 一覧 ......................................................................................................... 13
4.1. 基本設定情報取得............................................................................................................................ 13
4.2. プライオリティモード取得 ................................................................................................................... 13
4.3. VideoOverIP 画面情報取得............................................................................................................... 134.4. ネットワーク設定情報取得 ................................................................................................................. 14
4.5. システムログ情報取得 ...................................................................................................................... 14
5. RTMP 制御に関する CGI 一覧 ................................................................................................................. 15
5.1.RTMP 配信制御................................................................................................................................. 155.2.RTMP 配信状態取得.......................................................................................................................... 155.3.RTMP サーバー設定 .......................................................................................................................... 15
5.4.RTMP サーバー設定情報取得 ............................................................................................................ 16
6.RTSP での制御について ........................................................................................................................... 17
6.1. rtsp リクエスト用の URL について ....................................................................................................... 17

ネットワーク系 CGI 仕様書

1

1.はじめに
本書は、リモートカメラをネットワーク経由で操作する場合の映像配信やネットワーク応用操作に関する仕様書です。リモートカメラの一般的なカメラ操作については、別冊の『HD インテグレーテッドカメラインターフェース仕様書』を確認ください。
当社は、本情報の使用によって生じたいかなる損害に対しても、一切の責任を負いません。この情報は今後の製品のバージョンアップにより予告無しに変更の可能性があります。使用例は、あくまでも本シリーズ用の参考例です。
各プログラムに関してのサポートはできません。また、カメラとブラウザ間の通信については、公開しない情報があります。

アクセスレベルについて
本書内では、アクセスレベルとして Live と Admin を定義しています。リモートカメラの User auth.メニューにより、CGI実行時の ID/パスワードの必要有無が変化します。
User auth.が OFF の場合(工場出荷時)：
Live(映像取得やカメラ制御)
・・・ 認証不要
Admin(各種 SETUP 制御)
・・・ Administrator 権限の ID/パスワードが必要
User auth.が ON の場合：Live(映像取得やカメラ制御)
Admin(各種 SETUP 制御)

・・・ Camera control もしくは、Administrator 権限の ID/パスワードが必要
・・・ Administrator 権限の ID/パスワードが必要

プライオリティモードについてリモートカメラ本体のプライオリティモードによって実行できる CGI の種類およびパラメータ値の範囲が異なります。
詳しくは、取扱説明書を参照してください。

ネットワーク系 CGI 仕様書

2

2. 映像配信に関する CGI 一覧
2.1. 配信ユーザー管理：GET：Live

MethodAccess level
CGI 項目名
配信ユーザー管理

URL

パラメータ名/cgi-bin/getuid

パラメータ値

説明FILE

22(固定)

vcodecjpeg

jpeg :JPEG 配信時

h264

h264 :H.264 配信時

h265

h265 :H.265 配信時

browser

コマンド応答形式指定（省略可）

info

browser:カメラブラウザ用

info:アプリケーション用

reply使用例）ユーザーID の取得（H264 配信時）
http://192.168.0.10/cgi-bin/getuid?FILE=2&vcodec=h264
応答データは下記の通りです。
UID=< User ID >[CR][LF]

応答データの説明は下記の通りです。
項目
UID

ネットワーク系 CGI 仕様書

応答の値
数値

説明
ユーザーID3

2.2. JPEG 系画像配信
MethodAccess level：GET：Live

CGI 項目名URLJPEG 画像配信/cgi-bin/jpeg

パラメータ名connect(MJPEG)
framerate

パラメータ値

説明startstart：JPEG 画像配信開始

stop

stop：JPEG 画像配信停止[60Hz/59.94Hz]

10fps (AW-UE4 は 1280x720 のみ)

1030(25)fps : 640x360 のみ

30()内はシステム周波数が 50Hz の時[50Hz]
1025
resolution

UID

640

640：640x360

1280

1280：1280x720

数値ユーザーID※/cgi-bin/getuid で取得した UIDJPEG 画像配信/cgi-bin/mjpeg

resolution(MJPEG)
framerate640

640：640x360

1280

1280：1280x720[60Hz/59.94Hz]

10fps (AW-UE4 は 1280x720 のみ)

1030(25)fps : 640x360 のみ

30()内はシステム周波数が 50Hz の時[50Hz]
1025
JPEG 画像 1shot 要/cgi-bin/view.cgi

actionsnapshotsnapshot:JPEG 画像を 1 枚取得/cgi-bin/camera

resolution

640

640：640x360

1280

1280：1280x720

数値

キャッシュ無効用ダミー

求JPEG 画像 1shot 要
求page

ネットワーク系 CGI 仕様書

4

[Note]リモートカメラでは様々な手法で JPEG 映像を取得する手段を提供しています。用途にあわせて使用してください。
MJPEG
到達した映像を連続表示することで、動画表示を実現することが可能です。
フレームレートは引数で決定されます。
受信側のソフトウェアやハードウェアによっては対応していないものがあります。
JPEG 画像 1shot
1 枚の JPEG 画像を取得/表示/待機を繰り返すことで、動画表示を実現することが可能です。
フレームレートは受信側のソフトウェアやハードウェアでの待機時間で決定されます。

MJPEG 各 CGI の特徴は以下のとおりです。
/cgi-bin/jpeg
CGI を一回呼び出すと、MJPEG ストリームを連続的に送出します。
呼び出し前に、/cgi-bin/getuid での UID が必要です。
/cgi-bin/mjpeg
CGI を一回呼び出すと、MJPEG ストリームを連続的に送出します。
呼び出し前に、/cgi-bin/getuid での UID は不要です。
一部のモバイル端末から JPEG を呼び出す際に使用しています。
使用例）MJPEG 形式で、1280x720 の映像を 10fps で取得するとき：
http://192.168.0.10/cgi-bin/mjpeg?resolution=1280&framerate=10使用例）MJPEG 形式で、640x360 の映像を 30fps で取得するとき：
http://192.168.0.10/cgi-bin/mjpeg?resolution=640&framerate=30
使用例）MJPEG 形式で、1280x720、10fps の映像を取得するとき(パラメータ省略)：
http://192.168.0.10/cgi-bin/mjpeg

ネットワーク系 CGI 仕様書5

JPEG 画像 1shot 各 CGI の特徴は以下のとおりです。
/cgi-bin/view.cgiCGI を一回呼び出すと、JPEG 画像を 1 枚だけ送出します。
呼び出し前に、/cgi-bin/getuid での UID は不要です。
解像度は 1280x720, 640x360 のうち、set_jpeg で設定されているものとなります。
使用例）JPEG 画像 1shot 要求で、640x360 の映像を取得するとき：
http://192.168.0.10/cgi-bin/view.cgi?action=snapshot&n=3333<適切な待機時間>
http://192.168.0.10/cgi-bin/view.cgi?action=snapshot&n=3334<適切な待機時間>
http://192.168.0.10/cgi-bin/view.cgi?action=snapshot&n=3335/cgi-bin/camera
CGI を一回呼び出すと、JPEG 画像を 1 枚だけ送出します。
呼び出し前に、/cgi-bin/getuid での UID は不要です。

ネットワーク系 CGI 仕様書

6

2.3. MJPEG での画像配信シーケンス

Camera(server)

Client/cgi-bin/getuid?FILE=2&vcodec=jpeg&page=<page>

Ex. page=2345

200 OK

Ex. UID=12345/cgi-bin/jpeg?connect=start&framerate=30&resolution=640&UID=<UID>
200 OKHTTP JPEG stream 640x360/30fps

MJPEG Sequence

ネットワーク系 CGI 仕様書

7

2.4. JPEG 画像 1shot での画像配信シーケンス

Camera(server)

Client/cgi-bin/camera?resolution=640&page=<page>

Ex. page=3333

HTTP JPEG 1shot 640x360
wait/cgi-bin/camera?resolution=640&page=<page+1>
HTTP JPEG 1shot 640x360

Ex. page=3334
Different value neededwait/cgi-bin/camera?resolution=640&page=<page+2>
HTTP JPEG 1shot 640x360

Ex. page=3335
Different value needed

JPEG 1shot Sequence

ネットワーク系 CGI 仕様書

83. 各種設定に関する CGI 一覧
3.1. 基本設定
MethodAccess level：GET / POST：Admin

CGI 項目名

URL

基本設定/cgi-bin/set_basic

パラメータ名
cam_title

パラメータ値
文字列

説明
カメラタイトル(全角 20 文字以内)使用例）カメラタイトルの設定
http://192.168.0.10/cgi-bin/set_basic?cam_title=he20
MethodAccess level：GET：Admin

CGI 項目名

URL

プライオリティモード設/cgi-bin/set_priori

定ty_mode

パラメータ名mode

パラメータ値

説明ip

ip: IPusb

usb: HDMI/USB

ip_4k

ip_4k: IP(4K)

usb_4kusb_4k: USB(4K)hdmi_4k

hdmi_4k: HDMI(4K)

usb_video_co

usb_video_conference: USB(VideonferenceConference)

使用例）プライオリティモードを IP へ設定
http://192.168.0.10/cgi-bin/set_priority_mode?mode=ip

ネットワーク系 CGI 仕様書

93.2. Video over IP 設定
MethodAccess level：GET / POST：Admin

CGI 項目名
JPEG 設定

H.264 ストリーム設定

URL

パラメータ名/cgi-bin/set_jpeg

resol_stream1/cgi-bin/set_h264

パラメータ値

説明640

640 : 640x360

1280

1280 : 1280x720

jpeg_transmit

00：OFF 配信しない1

1

1：ON

jpeg_interval1[60Hz/59.94Hz]

JPEG のフレームレート

1010:10fps (AW-UE4 は 1280x720 の30み)[50Hz]

30(25):30(25)fps : 640x360 のみ

10※()内はシステム周波数が 50Hz の

25時

00：OFF 配信しない

1

1：ON

h264_resoluti

640

640: 640x360

on

1280

1280:1280x720

1920

1920:1920x1080

3840

3840: 3840x2160 (AW-HE20 では

h264_transmit

配信する

配信する選択不可)
framerate[60Hz/59.94Hz]

H.264 のフレームレート

5

5:5fps15

15(10):15(10)fps

30

30(25):30(25)fps

60

60(50):60(50)fps[50Hz]※()内はシステム周波数が 50Hz の

5時

102550H.265 ストリーム設定/cgi-bin/set_h265

00：OFF 配信しない11：ON

h265_resoluti

640

640:640x360

on12801280:1280x720

1920

1920:1920x1080

3840

3840: 3840x2160 (AW-HE20 では

h265_transmit

配信する選択不可)
framerate[60Hz/59.94Hz]

H.265 のフレームレート

5

5:5fps1515(10):15(10)fps

30

30(25):30(25)fps

60

60(50):60(50)fps[50Hz]※()内はシステム周波数が 50Hz の

5時

1025

ネットワーク系 CGI 仕様書

10

CGI 項目名

URL

パラメータ名パラメータ値

説明

パラメータ値

説明50

3.3. ネットワーク設定
MethodAccess level：GET / POST
：AdminCGI 項目名
ネットワーク設定

URL/cgi-bin/network

パラメータ名00：DHCP OFF(Static 設定)

1

1：DHCP ON

IP_addr1

0～255

IP アドレス 第 1 オクテット

IP_addr20～255

同 第 2 オクテット

IP_addr30～255

同 第 3 オクテット

IP_addr40～255

同 第 4 オクテット

netmask1

0～255

サブネットマスク 第 1 オクテット

netmask20～255

同 第 2 オクテット

netmask30～255

同 第 3 オクテット

netmask40～255

同 第 4 オクテット

gateway10～255

デフォルトゲートウェイ 第 1 オクテット

gateway20～255

同 第 2 オクテット

gateway30～255

同 第 3 オクテット

gateway40～255

同 第 4 オクテット

port

1～65535

1～65535

dns

manualmanual:マニュアル設定

auto

auto:自動設定

0～255

IPv4 プライマリーサーバアドレス(DNS)dhcp

pri_server1

第 1 オクテット
pri_server20～255

同 第 2 オクテット

pri_server30～255同 第 3 オクテット

pri_server40～255

同 第 4 オクテット

sec_server10～255

IPv4 セカンダリーサーバアドレス(DNS)
第 1 オクテット

sec_server20～255

同 第 2 オクテット

sec_server30～255

同 第 3 オクテット

sec_server40～255

同 第 4 オクテット

ip6_addr*:*:*:*:*:*:*:*形

IP アドレス式
ip6_gateway*:*:*:*:*:*:*:*形

デフォルトゲートウェイ式
ip6_pri_server*:*:*:*:*:*:*:*形

IPv6 プライマリーサーバアドレス(DNS)

式
IPv6 セカンダリーサーバアドレス(DNS)

ip6_sec_serv*:*:*:*:*:*:*:*形

er

式

time

20

IP 簡単設定の有効期限

unlimited

20：20 分unlimited：無制限

ネットワーク系 CGI 仕様書

11CGI 項目名URL

IP 簡単設定プロトコル/cgi-bin/easyipset

パラメータ名time

設定パラメータ値

説明20

電源投入から IP 簡単設定可能な時間

unlimited

20 ：20 分
unlimited：無制限

使用例）IP アドレスを 192.168.0.30 へ変更（ネットマスク 255.255.128.0、ゲートウェイ 192.168.0.50）
http://192.168.0.10/cgi-bin/network?IP_addr1=192&IP_addr2=168&IP_addr3=0&IP_addr4=30&netmask
1=255&netmask2=255&netmask3=128&netmask4=0&gateway1=192&gateway2=168&gateway3=0&gatew
ay4=503.4. 再起動
MethodAccess level：GET / POST：Admin

CGI 項目名
初期化

URL/cgi-bin/initial

パラメータ名パラメータ値説明

cmdreset

カメラの再起動Randomnum

16 進文字列

文字列半角 16 文字

使用例）リモートカメラの再起動
http://192.168.0.10/cgi-bin/initial?cmd=reset&Randomnum=12345

ネットワーク系 CGI 仕様書

124. 各種情報の取得に関する CGI 一覧
4.1. 基本設定情報取得
MethodAccess level：GET：LiveCGI 項目名

URL

基本設定情報取得

パラメータ名パラメータ値

説明

パラメータ名パラメータ値

説明/cgi-bin/get_basic

応答データは下記の通りです。
cam_title=カメラタイトル

4.2. プライオリティモード取得
MethodAccess level：GET：LiveCGI 項目名

URL

優先モード取得/cgi-bin/get_priori
ty_mode

応答データは下記の通りです。
priority_mode=xxx※xxx で通知する値は、set_priority_mode のパラメータを参照

4.3. VideoOverIP 画面情報取得
MethodAccess level：GET：Live

CGI 項目名

URLVideoOverIP 画面情/cgi-bin/get_vide

報取得

o_over_ip

パラメータ名パラメータ値

説明・応答は順不同

応答データは下記の通りです。
livestart_stream=jpeg/h264/h265
h264_resolution_ch1=1920
h264_framerate_ch1=5/15(10)/30(25)/60(50)

ネットワーク系 CGI 仕様書

13

4.4. ネットワーク設定情報取得
MethodAccess level：GET：Admin

CGI 項目名

URL

ネットワーク設定情報/cgi-bin/get_netw

取得

ork

パラメータ名パラメータ値

説明

パラメータ名パラメータ値

説明

応答データは下記の通りです。
ip4_dhcp=0/1
ip4_addr=*.*.*.*
ip4_netmask=*.*.*.*
ip4_gateway=*.*.*.*
ip4_pri_server=*.*.*.*
ip4_sec_server=*.*.*.*
port=数値(1~65535)
dns=auto/manual
ip6_auto=0/1
ip6_addr=*:*:*:*:*:*:*:*
ip6_gateway=*:*:*:*:*:*:*:*
ip6_pri_server=*:*:*:*:*:*:*:*
ip6_sec_server=*:*:*:*:*:*:*:*
ip6_dhcp=0/1
time=20/unlimited

4.5. システムログ情報取得
MethodAccess level：GET：Admin

CGI 項目名
システムログURL/cgi-bin/get_syst

type

eventlog

eventlog:イベントログ

errorlog

errorlog:エラーログ

num

100 (固定)

取得数

index

1 (固定)

取得開始位置

emlog（AW-UE4 は未対
応）応答データは下記の通りです。
no¥mm/dd/yyyy hh:mm¥event code¥description$no¥mm/dd/yyyy hh:mm¥event code¥description$・・・※改行なし。
各パラメータ間には"¥"が入る。
no1 と no2 の間など、no 間には"$"が入る。

ネットワーク系 CGI 仕様書

14

5. RTMP 制御に関する CGI 一覧
5.1.RTMP 配信制御
MethodAccess level：GET：LiveCGI 項目名

URL

RTMP 配信制御/cgi-bin/rtmp_ctrl

パラメータ名cmd

パラメータ値説明

start

start:RTMP 配信開始

stop

stop:RTMP 配信停止

5.2.RTMP 配信状態取得
MethodAccess level：GET：Live

CGI 項目名

URL

パラメータ名パラメータ値説明

RTMP 配信状態取得/cgi-bin/get_rtmp

RTMP 配信状態の取得_status

0:配信停止中
1:配信中

応答データは下記の通りです。
status=数値(0/1)

5.3.RTMP サーバー設定
MethodAccess level：GET：Admin

CGI 項目名

URL

RTMP サーバー設定/cgi-bin/set_rtmp

パラメータ名パラメータ値

説明

0

0:Server URL, Stream Key 連結方式

1

1:Server URL, Stream Key 分割方式

url文字列Server URL

key文字列Stream Key

type_param※type で 0 が指定されている場合は省略可能

ネットワーク系 CGI 仕様書

15

5.4.RTMP サーバー設定情報取得
MethodAccess level：GET：Admin

CGI 項目名

URL

RTMP サーバー設定/cgi-bin/get_rtmp

情報取得_paramパラメータ名パラメータ値

説明

応答データは下記の通りです。
type=0/1
url=文字列
key=文字列

ネットワーク系 CGI 仕様書

16

6.RTSP での制御について
リモートカメラは、一般的な RTSP プロトコルにも対応しています。本章では、RTSP での活用方法を例示します。
ご使用になる場合には、お客様に RTSP/RTP/RTCP の知識が必要になります。

6.1. rtsp リクエスト用の URL について
リモートカメラの RTSP リクエスト用の URL は以下の通りです。
Request URL
Description
rtsp://<cam_ip>/mediainput/h264/stream_1
set_h264 で設定した映像を要求できます。
rtsp://<cam_ip>/mediainput/h265/stream_1
set_h265 で設定した映像を要求できます。
※<cam_ip> ： カメラの IP アドレス

ネットワーク系 CGI 仕様書

17

Memo:

ネットワーク系 CGI 仕様書

18