POVCAM インターフェース仕様書

映像配信/クリップ操作編
対象機種
AG-UCK20,AG-UMR20
AG-MDC20,AG-MDR25

第 1.0 版
パナソニック株式会社

変更履歴
日付
2017/09/11

バージョン
V1.0 版

内容
初版リリースPOVCAM インターフェース仕様書 映像配信/クリップ操作編

2

目次
変更履歴 ....................................................................................................................................................... 2
1.はじめに ..................................................................................................................................................... 5
2. 映像配信に関する CGI 一覧 ...................................................................................................................... 6
2.1. 配信ユーザー管理 .............................................................................................................................. 6
2.2. 機器情報取得..................................................................................................................................... 8
2.3. 固有情報(Capability)取得 ................................................................................................................. 10
2.4. JPEG 系画像配信 ............................................................................................................................. 13
2.5. MJPEG での画像配信シーケンス ....................................................................................................... 16
2.6. JPEG 画像 1shot での画像配信シーケンス ........................................................................................ 17
2.7. H264/AUDIO 系画像配信.................................................................................................................. 18
2.8. H264 でのユニキャスト画像配信シーケンス ........................................................................................ 19
3. カメラ制御に関する CGI 一覧................................................................................................................... 20
3.1. カメラ制御 ........................................................................................................................................ 20
4. 各種設定に関する CGI 一覧 .................................................................................................................... 21
4.1. 優先モード/基本設定......................................................................................................................... 21
4.2. NTP/時計設定 .................................................................................................................................. 224.3. Video over IP 設定 ........................................................................................................................... 24
4.4. Audio 設定........................................................................................................................................ 28
4.5. マルチスクリーン設定 ........................................................................................................................ 30
4.6. ネットワーク設定 ............................................................................................................................... 31
4.7. UPnP の設定 .................................................................................................................................... 33
4.8. 再起動 ............................................................................................................................................. 33
5. 各種情報の取得に関する CGI 一覧 ......................................................................................................... 34
5.1. 優先モード設定情報取得................................................................................................................... 34
5.2. 基本設定情報取得............................................................................................................................ 34
5.3. NTP 設定情報取得 ........................................................................................................................... 35
5.4. 時計設定情報取得............................................................................................................................ 35
5.5. VideoOverIP 画面情報取得............................................................................................................... 36
5.6. Audio 設定情報取得.......................................................................................................................... 37
5.7. マルチスクリーン設定情報取得 .......................................................................................................... 37
5.8. ネットワーク設定情報取得 ................................................................................................................. 38
5.9. UPnP 設定情報取得 ......................................................................................................................... 38
5.10. UPnP 実行結果取得 ....................................................................................................................... 39
5.11. システムログ情報取得 .................................................................................................................... 39
5.12. その他の設定値取得 ...................................................................................................................... 40
6. 設定値一覧の取得 .................................................................................................................................. 43
7. HTTPS 制御に関する CGI 一覧 ............................................................................................................... 47
7.1. 情報の設定と証明書の取得 .............................................................................................................. 47
7.2. 情報の取得 ...................................................................................................................................... 48
8. SD カード記録に関する CGI 一覧 ............................................................................................................. 49
8.1. ビデオ記録モード設定 ....................................................................................................................... 49
8.2. ビデオ記録モード取得 ....................................................................................................................... 50
8.3. ビデオ記録メディアの設定 ................................................................................................................. 50
8.4. ビデオ記録メディアの取得 ................................................................................................................. 50
8.5. MP4 形式のビデオフォルダ名ファイル名の設定 .................................................................................. 51
8.6. MP4 形式のビデオフォルダ名ファイル名の取得 .................................................................................. 51
POVCAM インターフェース仕様書 映像配信/クリップ操作編

3

8.7. ビデオ記録の開始/終了制御 ............................................................................................................. 52
9.SD カードの状態取得およびフォーマット(初期化)に関する CGI 一覧 ............................................................ 53
9.1. SD カード関係の状態取得 ................................................................................................................. 53
9.2. SD カードのフォーマット(初期化)制御 ................................................................................................. 54
9.3. SD カードのフォーマット(初期化)進捗確認 .......................................................................................... 54
10.記録済みクリップ(MP4/AVCHD)に関する CGI 一覧 ................................................................................. 55
10.1. クリップ(MP4/AVCHD)リスト検索..................................................................................................... 55
10.2. クリップ(MP4/AVCHD)消去 ............................................................................................................. 56
10.3. クリップ(MP4/AVCHD)のダウンロード制御....................................................................................... 57
10.4. クリップ(MP4/AVCHD)のダウンロードシーケンス .............................................................................. 57
11. FTP 制御に関する CGI 一覧 .................................................................................................................. 58
11.1. FTP 概要 ........................................................................................................................................ 58
11.2. 転送先 FTP サーバー設定 .............................................................................................................. 59
11.3. FTP サーバー情報取得 ................................................................................................................... 59
11.4. リスト付転送開始指示/キャンセル .................................................................................................... 60
11.5. 転送進捗確認 ................................................................................................................................. 61
11.6. FTP 制御シーケンス ........................................................................................................................ 62
11.7. FTP サーバー側のフォルダ設定について.......................................................................................... 63
12.RTSP での制御について ......................................................................................................................... 64
12.1. rtsp リクエスト用の URL について ..................................................................................................... 64
12.2. rtsp メソッドについて ........................................................................................................................ 65
13. RTSP でのストリームの取得について ..................................................................................................... 66
13.1 UDP Unicast ................................................................................................................................... 66
13.2 UDP Multicast ................................................................................................................................. 70
13.3 TCP Unicast .................................................................................................................................... 74
13.4 rtpmap Attribute について ................................................................................................................ 78
14. RTCP での制御について ........................................................................................................................ 79
15. RTP/データフォーマットについて ............................................................................................................. 80
15.1. RTP ヘッダーフォーマット ................................................................................................................. 80
15.2. H.264/ES データとの関係 ................................................................................................................ 81
15.3. H.264 Syntax ................................................................................................................................. 82
15.4. Audio データフォーマット .................................................................................................................. 82

POVCAM インターフェース仕様書 映像配信/クリップ操作編

4

1.はじめに
本書は、メモリーカード・ポータブルレコーダーおよび専用オプションのコンパクト・カメラヘッドをネットワーク経由で操作する場合の映像配信やクリップ操作に関する仕様書です。一般的な操作については、取扱説明書を確認ください。
コマンド体系としては HD Integrated Camera と一部互換性があります。
一部のシーケンス図や説明においては、メモリーカード・ポータブルレコーダーおよび専用オプションのコンパクト・
カメラヘッドを単に”カメラ”と表現する場合があります。
当社は、本情報の使用によって生じたいかなる損害に対しても、一切の責任を負いません。この情報は今後の製品のバージョンアップにより予告無しに変更の可能性があります。使用例は、あくまでも本シリーズ用の参考例です。
各プログラムに関してのサポートはできません。また、カメラとブラウザ間の通信については、公開しない情報があります。

アクセスレベルについて
本書内では、アクセスレベルとして 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-bin/set_priority_mode、/cgi-bin/get_priority_mode)が、REC/PB 優先のとき⇒ H.264(2)の制御はできません。

POVCAM インターフェース仕様書 映像配信/クリップ操作編

5

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

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

URL

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

パラメータ値

説明

FILE

2

2(固定)

vcodecjpeg

jpeg :JPEG 配信時

h264

h264 :H.264(1)配信時

h264_2

h264_2:H.264(2)配信時

browser

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

info

browser:カメラブラウザ用

info:アプリケーション用

reply使用例）ユーザーID の取得（H264(1)配信時）
http://192.168.0.10/cgi-bin/getuid?FILE=2&vcodec=h264※パラメータ vcodec で指定した配信モードが使用できないときは、204 No Content を応答します。

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

応答の値

説明

UID

数値

ユーザーID

ImageFormat

jpeg,

JPEG 配信時

h264,

H.264(1)配信時

h264_X

H.264(X)配信時

ImageCaptureMode

2m

固定値

ratio

16_9

固定値

Maxfps30, 60

最大フレームレート

StreamMode

1

固定値

iBitrate

数値

H.264 のビットレート設定

iResolution

640,1280,1920,3840

H.264 の水平解像度設定

iQualityfine , low

H.264 の画質設定

sDelivery

uni,

uni：unicast(auto)

multi,

multi：multicast

uni_manual

uni_manual：unicast(manual)

iUniPort

1024 ～ 50000

ユニキャストポート番号（画像）iMultiAdd1

224 ～ 239

マルチキャストアドレスの第 1 オクテット

iMultiAdd2

0 ～ 255

マルチキャストアドレスの第 2 オクテット

iMultiAdd3

0 ～ 255

マルチキャストアドレスの第 3 オクテット

iMultiAdd4

0 ～ 255

マルチキャストアドレスの第 4 オクテット

iMultiAdd(IP アドレス)H.264 マルチキャストアドレス

iMultiPort

数値

マルチキャストポート番号

POVCAM インターフェース仕様書 映像配信/クリップ操作編

6

項目
aEnable

応答の値
off, in説明
off ：Audio OFF
in ： Audio ON(受話)

aEnc

2

固定値(2:AAC)

aBitrate

128,96,64

音声のビットレート設定

aBitrate2

64

固定値

aInterval

20

固定値

aInPort1024 ～ 50000

ユニキャストポート番号（音声）aOutInterval

640

固定値

aOutPort

34004

固定値

aOutStatus

off

固定値

aOutUID

0

固定値

ePort

31004

固定値

sAlarm

off

固定値

SDrec

disable固定値

SDrec2disable

固定値

sAUX

disable固定値

iHttpPort

数値

HTTP ポート番号

iMultiAuto_h264

0

固定値

iMultiAuto_h264_20

固定値

sRtspMode_h264

0

固定値

sRtspMode_h264_2

0

固定値

POVCAM インターフェース仕様書 映像配信/クリップ操作編

7

2.2. 機器情報取得
：GET
：Live

MethodAccess level
CGI 項目名
機器情報取得パラメータ名URL/cgi-bin/getinfo

FILE

パラメータ値1

説明
1(固定)使用例）機器情報の取得
http://192.168.0.10/cgi-bin/getinfo?FILE=1

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

応答の値

説明

MAC

XX-XX-XX-XX-XX-XX

MAC アドレスSERIALXXXXXXXXX

製品シリアル番号
ソフトウェアバージョン

VERSION
NAME

AG-XXXX

製品品番

SDrec

disable固定値

SDrec2disable

固定値

sAlarm

off

固定値

sAUX

off

固定値

ePort

31004

固定値

aEnableoff, inoff ：Audio OFF,

in ： Audio ON(受話)aEnc2

固定値(2:AAC)

aBitrate

128,96,64

音声のビットレート設定

aBitrate2

64

固定値

aInterval

20

固定値

aOutInterval

640

固定値

aOutPort

34004

固定値

aOutStatus

off

固定値

aOutUID0

固定値

aInPort_h2641024 to 50000

H.264(1) 音声 受話ポート番号

aInPort_h264_2

1024 to 50000

H.264(2) 音声 受話ポート番号sRtspMode_h264

0

固定値

sRtspMode_h264_2

0

固定値

ImageCaptureMode

2m

固定値

ratio

16_9

固定値

Maxfps30, 60

最大フレームレート

StreamMode1

固定値

iTransmit_h264

1

固定値

sDelivery_h264

uni,

uni ： ユニキャスト（オート）multi,

multi： マルチキャスト

uni_manual

uni_manual： ユニキャスト（マニュアル）

数値

H.264(1)のビットレート設定

iBitrate_h264

POVCAM インターフェース仕様書 映像配信/クリップ操作編

8

項目

応答の値

説明

iResolution_h264

640,1280,1920,3840

H.264(1)の水平解像度設定

iQuality_h264

fine , low

H.264(1)の画質設定

iMultiAuto_h264

0

固定値

iTransmit_h264_2

see.H.264(1)see.H.264(1)sDelivery_h264_2
iBitrate_h264_2
iResolution_h264_2
iQuality_h264_2
iMultiAuto_h264_2

POVCAM インターフェース仕様書 映像配信/クリップ操作編

9

2.3. 固有情報(Capability)取得
MethodAccess level：POST,GET：Live

CGI 項目名

URL

パラメータ名

固有情報(Capability)/cgi-bin/get_capability-

パラメータ値説明
次項目で説明-取得

使用例）固有情報(Capability)取得
http://192.168.0.10/cgi-bin/get_capability

応答データの説明は下記の通りです。
グループ名
commonパラメータ名パラメータ値

説明1.00

ケイパビィティフォーマットのバージョン

categorycamera

カテゴリー

type

fixed_dome

製品の形状

fisheyeno

魚眼カメラ

supported

ntsc,pal

対応するアナログカメラのビデオ信号(エンコー

capability_versionvideo_server.basic
video_server.basic.analogue_in

ダ)put
video_server.cam_ctrl.ptz

supportedyes

PTZ 機能の有無

zoom

20

ズーム倍率

el_zoom30

電子ズーム倍率

commandcamctrl

対応 PTZ コマンド

direct_16
direct_256d
direct_256r
video_server.cam_ctrl.brightne

supported

yes

明るさ制御コマンドのサポート

ss

commandcamctrl_bright

対応しているコマンドの種類

video_server.cam_ctrl.abf

supportedno

ABF コマンドのサポート

video_server.cam_ctrl.focus

supportedyes

フォーカスコマンドのサポート

video_server.cam_ctrl.auto_foc

supportedyes

オートフォーカスコマンドのサポート

video_server.cam_ctrl.bw

supportedno

白黒切り替えコマンドのサポート

video_server.cam_ctrl.auto_mo

supportednoオートモードのサポート

video_server.cam_ctrl.preset

supportedno

プリセット移動コマンドのサポート

video_server.image.sensor

aspect_ratio

16_9

センサーのアスペクト比

video_server.image

formatjpeg, mjpeg,

対応している画像配信方式

camctrl_IRIS

us

de

h264
video_server.image.jpeg

mode

2m_r16_9

対応している撮像モード

resolution

640x360

JPEG1 ショットにて対応している解像度パラメ
ータ

POVCAM インターフェース仕様書 映像配信/クリップ操作編

10

グループ名パラメータ名
quality

パラメータ値
0～9

説明
JPEG1 ショットにて対応している画質パラメー
タvideo_server.image.jpeg.resolu

2m_r16_9

640x360

配信可能な JPEG 解像度

2m_r16_9

640x360

配信可能な JPEG 解像度

640x360

60,60,60,60,60,

解像度毎の JPEG 画像 1 枚の最大データサイ

30,30,30,30,30,

ズ

tion_each_mode
video_server.image.jpeg.resolu
tion_each_mode_all
video_server.image.jpeg.max_size

単位[Kbyte]
値は、カンマ区切りで羅列されます
構成：＜値１＞,<値 2>,<値 3>,<値 4>,<値 5>,<
値 6>, ,,, ,<値(n)>, ,,video_server.image.jpeg.quality(JPEG 画質
設定のパラメータ）が、0,1,2,3,4,5,6,7,8,9 の時は、以下の意味を示します。
<値 1>: JPEG 画質設定が'0'の時の最大デー
タサイズ<値 2>: JPEG 画質設定が'1'の時の最大デー
タサイズ・・・<値 10>: JPEG 画質設定が'9'の時の最大デー
タサイズ
video_server.image.mjpeg

resolution

640x360

JPEG ストリームにて対応している解像度パラメータ

quality

0～9

JPEG ストリームにて対応している画質パラメータframerate

1～30

JPEG ストリームにて対応しているフレームレート
小数点以下は切り捨て
NTSC:1~30
PAL:1~25

video_server.image.mjpeg.max

2m_r16_930

JPEG ストリームの最大フレームレート

2m_r16_9

640x360

設定可能な JPEG 解像度

2m_r16_9

640x360

設定可能な JPEG 解像度

resolution

3840x2160,

H.264(1) にて対応している解像度パラメータ_framerate
video_server.image.mjpeg.reso
lution_each_mode
video_server.image.mjpeg.reso
lution_each_mode_all
video_server.image.h264

1920x1080,
1280x720,
640x360
stream_mode

bitrate,H.264(1) にて対応している配信モード

framerate,
best_effort
qualityfine, normal

POVCAM インターフェース仕様書 映像配信/クリップ操作編

H.264(1) にて対応している画質パラメータ11

グループ名パラメータ名bandwidth

パラメータ値

説明1024,1536,2048

H.264(1) にて対応しているビットレートパラメ,3072,4096,614

ータ

4,8192,10240,1
2288,14336,163
84,20480,24576,32768,40960,5
1200
framerate
video_server.image.h264.resol2m_r16_9

ution_each_mode

5,12.5,15,25,30,

H.264(1) にて対応しているフレームレートパラ

50,60

メータ

3840x2160,

対応する H.264(1)解像度

1920x1080,
1280x720,
640x360

video_server.image.h264.max_

2m_r16_960

対応する H.264(1)フレームレート最大値

framerate
video_server.image.h264-2

H264-1 と同じ

video_server.image.h264-2.res
olution_each_mode
video_server.image.h264-2.ma
x_framerate
video_server.audio

transmission

input

音声配信設定モード

video_server.audio.audio_input

number1

音声のマイク入力数

encode_typeaac-1c_64Kサポートしている音声入力エンコード方式

aac-1c_96K
aac-1c_128K
video_server.sdcard
video_server.sdcard.replay_mp

supportedyes

SD メモリーカード機能のサポート

media_typesd, sdhc, sdxc対応している SD メモリーカード種類

supportedno

カメラ内部の SD メモリーカードに保存された
MP4 ファイルを再生する機能のサポート

4
video_server.network

nw_bandwidth

1024,2048,4096

全体の配信量設定で対応しているパラメータ,8192,16384,32
768
video_server.network.ipv6

supportednoIPv6 対応状況

video_server.network.httpssupported

yes

HTTPS(SSL)対応状況

video_server.vmd

supportedno

VMD 対応状況

POVCAM インターフェース仕様書 映像配信/クリップ操作編

12

2.4. JPEG 系画像配信
MethodAccess level

：GET
：Live

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

パラメータ名connect(MJPEG)
framerate

パラメータ値説明

start

start：JPEG 画像配信開始

stop

stop：JPEG 画像配信停止

1

1fps

5

5fps

15(12.5)

15(12.5)fps

30(25)

30(25)fps()内はシステム周波数が 50Hz の時

resolution

640

640：640x360

UID

数値

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

resolution

640

640：640x360

framerate

1

1fps

5

5fps

15(12.5)

15(12.5)fps

30(25)

30(25)fps()内はシステム周波数が 50Hz の時

JPEG 画像 1shot 要/cgi-bin/view.cgi

snapshotsnapshot:JPEG 画像を 1 枚取得

start

start:JPEG 配信開始

stop

stop:JPEG 配信停止n数値

キャッシュ無効用ダミー

resolution

640

640：640x360

page

数値

キャッシュ無効用ダミー

action求

JPEG 画像 1shot 要
求/cgi-bin/camera

POVCAM インターフェース仕様書 映像配信/クリップ操作編

13

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

MJPEG 各 CGI の特徴は以下のとおりです。
/cgi-bin/jpeg
CGI を一回呼び出すと、MJPEG ストリームを連続的に送出します。
呼び出し前に、/cgi-bin/getuid での UID が必要です。
Internet Explorer でプラグインソフトが JPEG(1)を呼び出す際に使用しています。
具体的な使用例およびシーケンスは次章に掲載します。
/cgi-bin/mjpeg
CGI を一回呼び出すと、MJPEG ストリームを連続的に送出します。
呼び出し前に、/cgi-bin/getuid での UID は不要です。
一部のモバイル端末から JPEG を呼び出す際に使用しています。
Safari では、ブラウザの URL 欄に本 CGI を入力するだけで、動画表示が可能です。Internet Explorer
は対応していません。
使用例）MJPEG 形式で、640x360 の映像を 15fps で取得するとき：
http://192.168.0.10/cgi-bin/mjpeg?resolution=640&framerate=15

使用例）MJPEG 形式で、5fps 程度の映像を取得するとき(パラメータ省略)：
http://192.168.0.10/cgi-bin/mjpeg

POVCAM インターフェース仕様書 映像配信/クリップ操作編

14

JPEG 画像 1shot 各 CGI の特徴は以下のとおりです。
/cgi-bin/view.cgi
CGI を一回呼び出すと、JPEG 画像を 1 枚だけ送出します。
呼び出し前に、/cgi-bin/getuid での UID は不要です。
Internet Explorer でプラグインソフトを使用せず JPEG 画像を呼び出す際に使用しています。
使用例）JPEG 画像 1shot 要求で、640x360 の映像を取得するとき：
http://192.168.0.10/cgi-bin/view.cgi?action=start
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
電源 ON 後、start 指示は必須ですが、stop 指示については必須ではありません。なお start 指示は何度指示しても問題ありません。

/cgi-bin/camera
CGI を一回呼び出すと、JPEG 画像を 1 枚だけ送出します。
呼び出し前に、/cgi-bin/getuid での UID は不要です。
Internet Explorer でプラグインソフトがスクリーンショットを取得する際などに使用しています。

各 CGI に共通した注意事項は以下のとおりです
複数パソコンや受信機器から同時に映像取得した場合は、カメラ側でベストエフォート判断を実施します。このため、意図したフレームレート表示にならない場合があります。
WEB メニュー/Video over IP/JPEG/JPEG transmission が OFF の場合は、真っ黒の JPEG 画像で応答する
場合があります。

POVCAM インターフェース仕様書 映像配信/クリップ操作編

15

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

MJPEG Sequence

POVCAM インターフェース仕様書 映像配信/クリップ操作編

16

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

JPEG 1Shot Sequence

POVCAM インターフェース仕様書 映像配信/クリップ操作編

17

2.7. H264/AUDIO 系画像配信
MethodAccess level

：GET
：Live

CGI 項目名
H.264 画像配信

URL
/cgi-bin/h264

パラメータ名my_port

パラメータ値
数値

説明
H.264 の受信ポート番号※ユニキャスト設定時、本パラメータは省略できません

start

start：H.264 の配信開始

stop

stop：H.264 の配信停止

protocol

rtp

rtp：RTP 方式(省略可能)

UID

数値

ユーザーID

connect※/cgi-bin/getuid で取得した UID
stream音声配信/cgi-bin/audio

connect
protocolmy_port1

1: ストリーム 1

2

2: ストリーム 2

start

start：音声配信開始

stop

stop：音声配信停止

rtp

rtp：RTP 配信

httphttp：HTTP 配信

数値

音声データの受信ポート番号※protocol=rtp の時のみ
HTTP 配信時は省略可能

UID

数値

ユーザーID※/cgi-bin/getuid で取得した UID

キープアライブ/cgi-bin/keep_

mode

in

in：固定

mode

h.264

h.264：H.264 のキープアライブ

h.264_2

h.264_2：H.264(2)のキープアライブ

jpeg

jpeg：JPEG のキープアライブ

audio

audio：音声のキープアライブ

rtp

rtp：RTP 配信

httphttp：HTTP 配信

数値

ユーザーID

alive

protocolUID※/cgi-bin/getuid で取得した UID
stream1

1: ストリーム 1

2

2: ストリーム 2

使用例）H264(1)画像配信開始（ポート番号が「40000」、ユーザーID が「263」とした場合）
http://192.168.0.10/cgi-bin/h264?my_port=40000&connect=start&protocol=rtp&UID=263&stream=1
使用例）Audio 配信開始
http://192.168.0.10/cgi-bin/audio?my_port=38004&connect=start&protocol=rtp&UID=263&mode=in
使用例）キープアライブ(JPEG)
http://192.168.0.10/cgi-bin/keep_alive?mode=jpeg&protocol=http&UID=263

POVCAM インターフェース仕様書 映像配信/クリップ操作編

18

2.8. H264 でのユニキャスト画像配信シーケンス

H264 Sequence

POVCAM インターフェース仕様書 映像配信/クリップ操作編

19

3. カメラ制御に関する CGI 一覧
3.1. カメラ制御
MethodAccess level

：GET
：Live

CGI 項目名
カメラ制御

URL/cgi-bin/camctrl

パラメータ名times

1：デフォルトに戻る

up

up：1 段階 ZOOM UP する

down

down：1 段階 ZOOM DOWN する

0

0：デフォルトに戻る

1

1：デフォルトに戻る

up

up：1 段階 ZOOM UP する

down

down：1 段階 ZOOM DOWN する

0

0：デフォルトに戻る

1

1：デフォルトに戻る

up

up：1 段階明るさが UP する

down

down：1 段階明るさが DOWN する-2-2：明るさを 2 段階 DOWN する

0

0：明るさを標準に戻す（リセットする）

2

2：明るさを 2 段階 UP する

1

1：デフォルトに戻る

up

up：1 段階明るさが UP する

down

down：1 段階明るさが DOWN する-2-2：明るさを 2 段階 DOWN する

0

0：明るさを標準に戻す（リセットする）

2

2：明るさを 2 段階 UP する

focus-3,3,on

-3：近く

,

3：遠く

, on:オートaf-3,3,on

-3：近く

,

3：遠く

, on:オート

zoom

-4～4

負が ZOOM DOWN、正が ZOOM UP

focus

-4～4

負が近、正が遠brightiris/cgi-bin/directctrl

説明

1

zoom

カメラ制御ダイレクトパラメータ値※専用オプションのコンパクト・カメラヘッドへの制御になります。
※本 CGI は後方互換用です。コンパクト・カメラヘッドでは、cgi-bin/aw_ptz を使用したほうが、高機能な制御が可能です。

POVCAM インターフェース仕様書 映像配信/クリップ操作編

20

4. 各種設定に関する CGI 一覧
4.1. 優先モード/基本設定
MethodAccess level
CGI 項目名
優先モード設定：POST：AdminURL/cgi-bin/set_priori

パラメータ名mode/cgi-bin/set_basic

説明

ip

IP

rec_pb

REC/PB

ip_4k

IP(4K)

rec_pb_4k

REC/PB(4K)

cam_title

文字列

カメラタイトル(20 文字以内)

plugin_downl

enable

プラグインソフトウェアの自動インストー

oaddisableル

ty_mode基本設定

パラメータ値

enable：を許可する
disable：許可しない
plugin_disp

00：リアルタイム重視（Off）

1

1：スムーズ表示（On）

使用例）優先モードを IP へ設定
http://192.168.0.10/cgi-bin/set_priority_mode?mode=ip

使用例）カメラタイトルの設定
http://192.168.0.10/cgi-bin/set_basic?cam_title=UCK20POVCAM インターフェース仕様書 映像配信/クリップ操作編

21

4.2. NTP/時計設定
MethodAccess level：POST：AdminCGI 項目名NTP 設定時計設定

URL

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

time_adjust/cgi-bin/date_tim

パラメータ値

説明

0

0:マニュアル1

1:NTP サーバーに同期

ntp_addr_dhc

0

0 ：OFF(手動入力）

p

1

1 ：ON(DHCP から取得）

ntp_addr

文字列

IP アドレス(IPv4)

ntp_port

数値

1～65535

ntp_interval

数値

1～24(時間)

display

0

0:off

1

1:on

date_year

2013~2035

年

date_month

1~12

月

date_day

1~31日

date_hour

0~23

時間

date_min0~59分

date_sec

0~59

秒

timezone

1～33

1:GMT-11:00

e

2:GMT-10:00
3:GMT-09:00
4:GMT-08:00
5:GMT-07:00
6:GMT-06:00
7:GMT-05:00
8:GMT-04:30
9:GMT-04:00
10:GMT-03:30
11:GMT-03:00
12:GMT-02:00
13:GMT-01:00
14:GMT
15:GMT+01:00
16:GMT+02:00
17:GMT+03:00
18:GMT+03:30
19:GMT+04:00
20:GMT+04:30
21:GMT+05:00
22:GMT+05:30
23:GMT+05:45
24:GMT+06:00
25:GMT+06:30
26:GMT+07:00
27:GMT+08:00

POVCAM インターフェース仕様書 映像配信/クリップ操作編

22

CGI 項目名

URL

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

説明
28:GMT+09:00
29:GMT+09:30
30:GMT+10:00
31:GMT+11:00
32:GMT+12:00
33:GMT+12:45

summer_time

00:サマータイム時間としない(Out)1

1:サマータイム時間とする(In)2

2:サマータイムを(Start/End)にあわせて自動調整する(Auto)start_month

1～12

1: 1 月～12: 12 月

start_week

1～5

1:第 1 週 , 2:第 2 週 , 3:第 3 週
4:第 4 週 , 5:最終週

start_dotw

0～6

0: 日曜日～6: 土曜日

start_hour

0～23

0～23

end_month

1～12

1: 1 月～12: 12 月

end_week

1～5

1:第 1 週 , 2:第 2 週 , 3:第 3 週
4:第 4 週 , 5:最終週

end_dotw

0～6

0: 日曜日～6: 土曜日

end_hour

0～23

0～23

使用例）NTP の設定
http://192.168.0.10/cgi-bin/time?time_adjust=1&ntp_addr_dhcp=0&ntp_addr=192.168.0.1&ntp_port=123&ntp_interval=12
使用例）時計の設定
http://192.168.0.10/cgi-bin/date_time?display=0&date_year=2018&date_month=1&date_day=1&date_ho
ur=0&date_min=0&date_sec=0&summer_time=0

POVCAM インターフェース仕様書 映像配信/クリップ操作編

23

4.3. Video over IP 設定
MethodAccess level：POST：AdminCGI 項目名
JPEG 設定

URL

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

jpeg_quality

パラメータ値0~9

説明
0~4:高画質
5~9:低画質

resol_stream1

640

640 : 640x360

jpeg_transmit

00：OFF 配信しない

1

1

1：ON

jpeg_interval1

5

JPEG(1)のフレームレート

15(12.5)

5:5fps30(25)

15(12.5):15(12.5)fps

配信する

30(25):30(25)fps※()内はシステム周波数が 50Hz の時
JPEG ストリーム設定/cgi-bin/setdata

LIVESIZE

640

JPEG(1)の解像度

LIVEQUAL

0~9

JPEG(1)の画質
0~4:高画質
5~9:低画質

H.264(1) ストリーム/cgi-bin/set_h264

h264_transmit

設定

0

0：OFF 配信しない
配信する

1

1：ON

h264_rtsp_m0

インターネットモード設定

ode

1

0：OFF
1：ON

h264_resoluti

640

640：640x360

on

1280

1280：1280x720

1920

1920:1920x1080

3840

3840:3840x2160

00：固定ビットレート

1

1：フレームレート優先2

2：ベストエフォート配信5

5:5fps15(12.5)

15(12.5):15(12.5)fps

30(25)

30(25):30(25)fps

60(50)

60(50):60(50)fps

f_priority

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

POVCAM インターフェース仕様書 映像配信/クリップ操作編

24

CGI 項目名

パラメータ名URL

パラメータ値

説明

h264_bandwi

1024

1024:1024(kbps)

dth

1536

1536：1536(kbps)

2048

2048：2048(kbps)

3072

3072：3072(kbps)

4096

4096：4096(kbps)

6144

6144:6144(kbps)

8192

8192：8192(kbps)

10240

10240:10240(kbps)

12288

12288:12288(kbps)

14336

14336:14336(kbps)

16384

16384:16384(kbps)

20480

20480:20480(kbps)

24576

24576:24576(kbps)

32768

32768:32768(kbps)

40960

40960:40960(kbps)

51200

51200:51200(kbps)

h264_bandwi

1024※f_priority=2(ベストエフォート配信)の

dth_min~51200時設定可能

h264_quality

fine

fine：画質優先

low

low：動き優先

uni

uni：unicast(auto)

multi

multi：multicast

h264_unimulti

uni_manual

uni_manual：unicast(manual)

unicast_port

1024～50000

ポート番号：1024～50000

unicast_audio

1024～50000

ポート番号：1024～50000

224～239224.0.0.0 - 239.255.255.255_port
multicast_add
r1
multicast_add

0～255

r2
multicast_add

0～255

r3
multicast_add

0～255

r4
multicast_add*.*.*.*形式*.*.*.*形式

multicast_port

1024～50000

1024～50000

multicast_ttl

1～254

1～254

h264_transmit

00：OFF 配信しない 1：ONr

H.264(2) ストリーム/cgi-bin/set_h264

設定

_2

配信する

1
h264_rtsp_m0

インターネットモード設定

ode

1

0：OFF
1：ON

h264_resoluti

640

640：640x360

on

1280

1280：1280x720

f_priority

00：固定ビットレート

1

1：フレームレート優先

POVCAM インターフェース仕様書 映像配信/クリップ操作編

25

CGI 項目名

パラメータ名URL

framerate

パラメータ値説明2

2：ベストエフォート配信5

5:5fps15(12.5)

15(12.5):15(12.5)fps

30(25)

30(25):30(25)fps※()内はシステム周波数が 50Hz の時

h264_bandwi

1024

1024:1024(kbps)

dth

1536

1536：1536(kbps)

2048

2048：2048(kbps)

3072

3072：3072(kbps)

4096

4096：4096(kbps)

6144

6144:6144(kbps)

8192

8192：8192(kbps)

10240

10240:10240(kbps)

12288

12288:12288(kbps)

14336

14336:14336(kbps)

16384

16384:16384(kbps)

20480

20480:20480(kbps)

24576

24576:24576(kbps)

h264_bandwi

1024※f_priority=2(ベストエフォート配信)の

dth_min~24576

時設定可能

h264_quality

fine

fine：画質優先

low

low：動き優先

uni

uni：unicast(auto)

multi

multi：multicast

uni_manual

uni_manual：unicast(manual)

unicast_port

1024～50000

ポート番号：1024～50000

unicast_audio

1024～50000

ポート番号：1024～50000

224～239224.0.0.0 - 239.255.255.255

h264_unimulti_port
multicast_add
r1
multicast_add

0～255

r2
multicast_add

0～255

r3
multicast_add

0～255

r4
multicast_add*.*.*.*形式*.*.*.*形式

multicast_port

1024～50000

1024～50000

multicast_ttl

1～254

1～254

rtsp_port

1～65535

1～65535r

RTSP 設定/cgi-bin/set_rtsp※工場出荷時は 554 に設定
h264_rtsp_m0

H264(1)のインターネットモード設定

ode

1

0：OFF 配信しない
1：ON

POVCAM インターフェース仕様書 映像配信/クリップ操作編

配信する

26

CGI 項目名

URL

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

説明

h264_rtsp_m0

H264(2)のインターネットモード設定

ode2

1

0：OFF 配信しない
1：ON

ライブ画面初期ストリ/cgi-bin/set_livest

ーム選択

art

stream

配信する

h264

h264：H264(1)h264_2

h264_2：H.264(2)jpeg

jpeg：JPEG(1)POVCAM インターフェース仕様書 映像配信/クリップ操作編

27

4.4. Audio 設定
MethodAccess level：POST/GET：AdminCGI 項目名
音声設定

パラメータ名URL/cgi-bin/set_audi

audio

o

パラメータ値

説明

off

off

：OFF

in

in

：ON

0

0：OFF

1

1：ON
※audio_sens とセットで設定してくださいaudio_encode

aac

エンコーダーの設定 AAC(固定)lmiddlemiddle:マイク

line_middle

line_middle:ライン

sdi

sdi:SDIr
audio_sens※audio=1 とセットで設定してください
audio_bitrate

64

64：64Kbps

96

96:96Kbps

128

128:128Kbps

00：ALC 設定 OFF

1

1：ALC 設定 ON

0

0 : Off

1

1 : Onaudio_transmi

0

0 : Offt

1

1 : Onequalizer

off

off : Off

low_cut

low_cut : 低域カット

0

0 : Off(マニュアル設定)

1

1 : On(自動設定)

external

external 外部マイク

internal

internal

audio_alc
plugin_power

audio_lv_auto
mic_selectMethodAccess level：POST：AdminCGI 項目名
音量レベル設定内部マイク

URL/cgi-bin/set_volu

パラメータ名volume_lv

パラメータ値0～23

説明
0～23 段階

me_lv

POVCAM インターフェース仕様書 映像配信/クリップ操作編

28

音声入力を有効にする場合は、audio と audio_sens をセットで設定してください
audio_sens が指定されない場合はエラーを返します

使用例）カメラヘッド利用時に音声入力を内蔵マイクに設定する
http://192.168.0.10/cgi-bin/set_audio?audio=1&audio_sens=middle&mic_select=internal使用例）レコーダー利用時に音声入力を外付 MIC に設定する
http://192.168.0.10/cgi-bin/set_audio?audio=1&audio_sens=middle&mic_select=external使用例）レコーダー利用時に音声入力を LINE に設定する
http://192.168.0.10/cgi-bin/set_audio?audio=1&audio_sens=line_middle使用例）レコーダー利用時に音声入力を SDI に設定する
http://192.168.0.10/cgi-bin/set_audio?audio=1&audio_sens=sdi

使用例）レコーダー利用時に音声入力をプラグインパワーマイクに設定する
http://192.168.0.10/cgi-bin/set_audio?audio=1&audio_sens=middle&mic_select=external&plugin_power=1

使用例）音声入力を切に設定する
http://192.168.0.10/cgi-bin/set_audio?audio=0

POVCAM インターフェース仕様書 映像配信/クリップ操作編

29

4.5. マルチスクリーン設定
MethodAccess level：POST：AdminCGI 項目名

URL

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

説明

マルチスクリーン設定/cgi-bin/multi_scr

multi_addr1"*.*.*.*"形式"*.*.*.*"形式

eenmulti_addr2

or"*.*.*.*:1～65535" ormulti_addr3"*.*.*.*:1～"文字列" ormulti_addr465535" or"文字列":1～65535"

multi_addr5"文字列" ormulti_addr6"文字列":1～

multi_addr765535"

ormulti_addr8
multi_addr9
multi_addr10
multi_addr11
multi_addr12
multi_addr13
multi_addr14
multi_addr15
multi_addr16
multi_name1

文字列(全角 20

multi_name2

文字以内)

カメラの名称

multi_name3
multi_name4
multi_name5
multi_name6
multi_name7
multi_name8
multi_name9
multi_name10
multi_name11
multi_name12
multi_name13
multi_name14
multi_name15
multi_name16

使用例）1 番目の枠に、192.168.0.100/UCK20 を設定する
http://192.168.0.10/cgi-bin/multi_screen?multi_addr1=192.168.0.100&multi_name1=UCK20POVCAM インターフェース仕様書 映像配信/クリップ操作編

30

4.6. ネットワーク設定
MethodAccess level
CGI 項目名
ネットワーク設定：POST：AdminURL/cgi-bin/network

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

説明

0

0：DHCP OFF(Static 設定)

1

1：DHCP ON

IP_addr1

0～255

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

IP_addr2

0～255

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

IP_addr3

0～255

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

IP_addr4

0～255

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

netmask1

0～255

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

netmask2

0～255

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

netmask3

0～255

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

netmask4

0～255

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

gateway1

0～255

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

gateway2

0～255

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

gateway3

0～255

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

gateway4

0～255

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

port

1～65535

1～65535

dns

manualmanual:マニュアル設定

auto

auto:自動設定

0～255

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

dhcp

pri_server1

オクテット
pri_server2

0～255

プライマリーサーバアドレス(DNS) 第 2
オクテット

pri_server3

0～255

プライマリーサーバアドレス(DNS) 第 3
オクテット

pri_server4

0～255

プライマリーサーバアドレス(DNS) 第 4
オクテット

sec_server1

0～255

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

sec_server2

0～255

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

sec_server3

0～255

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

sec_server4

0～255

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

rtp_packet_m

1500

RTP パケット最大送信サイズ

ax

1280

1500：無制限(1500byte)
1280：制限あり(1280byte)

mss

1460

TCP の最大セグメントサイズ（MSS）

1280

1460：無制限(1460byte)

1024

1280：制限あり(1280byte)
1024：制限あり(1024byte)

POVCAM インターフェース仕様書 映像配信/クリップ操作編

31

CGI 項目名

URL

パラメータ名time

パラメータ値

説明

20

有効期限

unlimited

20：20 分unlimited：無制限

bandwidth0

ネットワーク全体の配信量1024

0：Unlimited(制限無し)

2048

1024：1024kbps

4096

2048：2048kbps

8192

4096：4096kbps

16384

8192：8192kbps

32768

16384：16384kbps

1000032768：32768kbps
10000：Unlimited(制限無し)※10000 を受信した場合は、エラーとせず、Unlimited として動作させる。

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

rtsp_port

1～65535

RTSP 待ち受けポート番号

time

unlimited,

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

20

間

設定

unlimited：無制限
20 ：20 分
ネットワーク全体の配/cgi-bin/set_band

信量

width

bandwidth0

ネットワーク全体の配信量1024

0：Unlimited(制限無し)

2048

1024：1024kbps

4096

2048：2048kbps

8192

4096：4096kbps

16384

8192：8192kbps

32768

16384:16384kbps

1000032768:32768kbps
10000：Unlimited(制限無し)※10000 を受信した場合は、エラーとせず、Unlimited として動作させる。

最大パケット長設定/cgi-bin/set_rtp

rtp_size

1280

1280:最大パケット長制限

1500

1500:通常のパケット長

POVCAM インターフェース仕様書 映像配信/クリップ操作編

32

4.7. UPnP の設定
MethodAccess level：POST：AdminCGI 項目名
UPnP 設定

URL/cgi-bin/upnp

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

説明

upnp_portma0

自動ポートフォワーディング

p

1

0 ：無効
1 ：有効

使用例）UPnP を ON に設定する
http://192.168.0.10/cgi-bin/upnp?upnp_portmap=1

4.8. 再起動
MethodAccess level
CGI 項目名
初期化：POST：AdminURL/cgi-bin/initial

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

説明

cmd

reset

カメラの再起動

Randomnum

16 進文字列

文字列半角 16 文字

使用例）再起動http://192.168.0.10/cgi-bin/initial?cmd=reset&Randomnum=12345

POVCAM インターフェース仕様書 映像配信/クリップ操作編

33

5. 各種情報の取得に関する CGI 一覧
5.1. 優先モード設定情報取得
MethodAccess level

：GET
：Live

CGI 項目名
優先モード取得

URL

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

説明/cgi-bin/get_priori
ty_mode

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

5.2. 基本設定情報取得
MethodAccess level

：GET
：Live

CGI 項目名
基本設定情報取得

URL

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

説明/cgi-bin/get_basic

応答データは下記の通りです。
cam_title=カメラタイトル
plugin_download=enable/disable
plugin_disp=0/1

POVCAM インターフェース仕様書 映像配信/クリップ操作編

34

5.3. NTP 設定情報取得
MethodAccess level：GET：AdminCGI 項目名URL

NTP 設定情報取得/cgi-bin/get_time

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

説明

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

説明

応答データは下記の通りです。
time_adjust=0/1
ntp_addr_dhcp=0/1
ntp_addr=文字列
ntp_port=数値(1~65535)
ntp_interval=数値(1~24)

5.4. 時計設定情報取得
MethodAccess level

：GET
：Live

CGI 項目名
時計設定情報取得

URL/cgi-bin/get_date_time

応答データは下記の通りです。
display=0/1
date_year=数値
date_month=数値
date_day=数値
date_hour=数値
date_min=数値
date_sec=数値
timezone=数値(1~74)
summer_time=0/1/2
start_month=数値
start_week=数値(1~5)
start_dotw=数値(0~6)
start_hour=(0~23)
end_month=数値
end_week=数値(1~5)
end_dotw=数値(0~6)
end_hour=数値(0~23)
is_summer_time=0/1(0:OFF,1:ON)

POVCAM インターフェース仕様書 映像配信/クリップ操作編

35

5.5. VideoOverIP 画面情報取得
MethodAccess level

：GET
：Live

CGI 項目名

URL

パラメータ名パラメータ値説明VideoOverIP 画面情/cgi-bin/get_vide

・応答は順不同

報取得

o_over_ip

・特定の ch が仕様により配信できない
場合は対象の ch の応答は返らないもしくは無効値になります。

応答データは下記の通りです。
livestart_stream=h264/h264_2/jpeg
jpeg_quality=1/5
resol_stream1=640
jpeg_transmit1=0/1
jpeg_interval1=5/15(12.5)/30(25)h264_transmit_ch1=0/1
h264_transmit_ch2=0/1
h264_rtsp_mode_ch1=0/1
h264_rtsp_mode_ch2=0/1
h264_resolution_ch1=640/1280/1920/3840
h264_resolution_ch2=640/1280
h264_f_priority_ch1=0/1/2
h264_f_priority_ch2=0/1/2
h264_framerate_ch1=5/15(12.5)/30(25)/60(50)h264_framerate_ch2=5/15(12.5)/30(25)h264_bandwidth_ch1=数値
h264_bandwidth_ch2=数値
h264_bandwidth_min_ch1=数値
h264_bandwidth_min_ch2=数値
h264_quality_ch1=fine/low1/5
h264_quality_ch2=fine/low1/5
h264_unimulti_ch1=uni/multi/uni_manualh264_unimulti_ch2=uni/multi/uni_manualh264_unicast_port_ch1=数値(1024~50000)
h264_unicast_port_ch2=数値(1024~50000)
h264_unicast_audio_port_ch1=数値(1024~50000)
h264_unicast_audio_port_ch2=数値(1024~50000)
h264_multicast_addr_ch1=xxx.xxx.xxx.xxx
h264_multicast_addr_ch2=xxx.xxx.xxx.xxx
h264_multicast_port_ch1=数値(1024~50000)
h264_multicast_port_ch2=数値(1024~50000)
h264_multicast_ttl_ch1=数値(1~254)
h264_multicast_ttl_ch2=数値(1~254)

POVCAM インターフェース仕様書 映像配信/クリップ操作編

36

5.6. Audio 設定情報取得
MethodAccess level

：GET
：Live

CGI 項目名

URL

音声設定情報取得

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

説明

パラメータ値

説明/cgi-bin/get_audio

応答データは /cgi-bin/set_audio を参照ください。

5.7. マルチスクリーン設定情報取得
MethodAccess level

：GET
：Live

CGI 項目名

URL

マルチスクリーン設定/cgi-bin/get_multi

情報取得_screen

パラメータ名

応答データは下記の通りです。
multi_addr1="*.*.*.*"形式/"*.*.*.*:1～65535"/"文字列"/"文字列":1～65535"
multi_name1=文字列(全角 20 文字以内)
multi_addr2="*.*.*.*"形式/"*.*.*.*:1～65535"/"文字列"/"文字列":1～65535"
multi_name2=文字列(全角 20 文字以内)
multi_addr3="*.*.*.*"形式/"*.*.*.*:1～65535"/"文字列"/"文字列":1～65535"
multi_name3=文字列(全角 20 文字以内)
multi_addr4="*.*.*.*"形式/"*.*.*.*:1～65535"/"文字列"/"文字列":1～65535"
・・・
multi_addr16="*.*.*.*"形式/"*.*.*.*:1～65535"/"文字列"/"文字列":1～65535"
multi_name16=文字列(全角 20 文字以内)

POVCAM インターフェース仕様書 映像配信/クリップ操作編

37

5.8. ネットワーク設定情報取得
MethodAccess level：GET：AdminCGI 項目名

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
rtp_packet_max=1500/1280
mss=1024/1280/1460
bandwidth=0/64/128/256/384/512/768/1024/2048/4096/8192
time=20/unlimited
rtsp_port=0(固定)5.9. UPnP 設定情報取得
MethodAccess level：GET：AdminCGI 項目名URL

UPnP 設定情報取得/cgi-bin/get_upnp

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

説明

応答データは下記の通りです。
upnp_portmap=0/1

POVCAM インターフェース仕様書 映像配信/クリップ操作編

38

5.10. UPnP 実行結果取得
MethodAccess level：GET：AdminCGI 項目名
ステータス取得

パラメータ名URL/cgi-bin/get_statu-

パラメータ値説明
UPnP の実行結果-s

応答データは下記の通りです。
http_port=数値
http_status=enable/disable
https_port=数値
https_status=enable/disable
addr=文字列

5.11. システムログ情報取得
MethodAccess level：GET：AdminCGI 項目名
システムログ

URL

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

説明/cgi-bin/get_syst

type

eventlog

eventlog:イベントログ

emlog

num

数値(1~300)

取得数

index

数値(1~300)

取得開始位置使用例）イベントログ取得
http://192.168.0.10/cgi-bin/get_systemlog?type=eventlog

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

POVCAM インターフェース仕様書 映像配信/クリップ操作編

39

5.12. その他の設定値取得
MethodAccess level
CGI 項目名
設定値取得 CGI

：GET
：AdminURL/cgi-bin/getdata

パラメータ名req

パラメータ値説明-

取得したい設定値の項目名を指定する

img_mode

撮像モード

imgratio

画像比率

img_fps

フレームレート

livestream

ライブ画面初期ストリーム選択

liveint

liveint：JPEG(1)更新速度

livequalbase

livequalbase: JPEG(1)デフォルト画質

livesize

livesize：JPEG(1)画像解像度

livequal

livequal：JPEG(1)画質

h264

H264(1)配信 ON／OFF

h264rtspmode

インターネットモード(H.264 配信
1)ON/OFFh264bwc

1 クライアントあたりのビットレート

nrh264bwc

配信停止しない 1 クライアントあたりのビットレートh264bwcmin

H.264(1) 1 クライアントあたりのビットレート(最小)

h264rtspmode_2

h264rtspmode_2：インターネットモード(H.264 配信 2)ON/OFF

rtspport

rtspport：RTSP サーバポート番号h264size

h.264size：h.264 解像度

h264qual

h.264qual：h.264 画質

h264rint

h.264rint：リフレッシュ周期（Ｉフレーム
周期）

h264mtd

h.264mtd：h.264 配信方式

h264mladd1

h.264mladd1：h.264 マルチキャストア
ドレス 第 1 オクテット

h264mladd2

h.264mladd2：h.264 マルチキャストア
ドレス 第 2 オクテット

h264mladd3

h.264mladd3：h.264 マルチキャストア
ドレス 第 3 オクテット

h264mladd4

h.264mladd4：h.264 マルチキャストア
ドレス 第 4 オクテット

h264mlporth.264mlport：h.264 マルチキャスト送
信先ポート番号h264mlttl

h.264mlttl：h.264 マルチキャスト TTL

h264uniporth.264uniport：ユニキャスト（映像用）ポート番号

h264uniport2

h.264uniport2：ユニキャスト（音声用）
ポート番号

h264profile

POVCAM インターフェース仕様書 映像配信/クリップ操作編

H.264 プロファイル

40

CGI 項目名

URL

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

説明

h264codind

H.264 符号化方式

h264_2h.264_2：h.264 配信 ON／OFF2

h264bwc_2

h.264bwc_2：１クライアントあたりのビットレート 2h264size_2

h.264size_2：h.264 解像度 2

h264qual_2

h.264qual_2：h.264 画質 2

h264rint_2

h.264rint_2：リフレッシュ周期（Ｉフレー
ム周期）2h264mtd_2

h.264mtd：h.264 配信方式 2h264mladd1_2

h.264mladd1_2：h.264 マルチキャスト
アドレス 第 1 オクテット 2

h264mladd2_2

h.264mladd2_2：h.264 マルチキャスト
アドレス 第 2 オクテット 2

h264mladd3_2

h264mladd3_2：h264 マルチキャストア
ドレス 第 3 オクテット 2

h264mladd4_2

h264mladd4_2：h264 マルチキャストア
ドレス 第 4 オクテット 2

h264mlport_2

h264mlport_2：h264 マルチキャスト送
信先ポート番号 2

h264mlttl_2

h264mlttl_2：h264 マルチキャスト
TTL2

h.264uniport_2

h.264uniport_2：ユニキャスト（映像用）
ポート番号 2

h264uniport2_2

h.264uniport2_2：ユニキャスト（音声用）ポート番号 2

h264profile_2

H.264 プロファイル 2

h264codind_2

H.264 符号化方式 2h264mlauto

H264(1)マルチキャストオートスタート

h264mlauto_2

H264(2)マルチキャストオートスタート

audio_level

audio_level:音声許可認証レベル設定

audio_sensaudio_sens:集音感度

nrlivequal

nrlivequal：配信停止しない JPEG 画質

nrh264size

nrh264size：配信停止しない H.264 解
像度

nrh264qual

nrh264qual：配信停止しない H.264 画
質

nrh264bwc_2

nrh264bwc_2：配信停止しない 1 クライ
アントあたりのビットレート 2

nrh264size_2

nrh264size_2：配信停止しない H.264
解像度 2

nrh264qual_2

nrh264qual_2：配信停止しない H.264
画質 2h264fpriority

h264fpriority：H.264(1) 配信モード

h264nrframerate

h264nrframerate：H.264(1) フレームレート

POVCAM インターフェース仕様書 映像配信/クリップ操作編

41

CGI 項目名

URL

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

説明

h264fpriority_2

h264fpriority_2：H.264(2) 配信モード

h264nrframerate_2

h264nrframerate_2：H.264(2) フレー
ムレート

h264bwcmin_2

H.264(2) １クライアントあたりのビット
レート(最小)(なし)

livequalbase

JPEG デフォルト画質

liveframerate

ライブ画面初期フレームレート（JPEG）

plugin_halftone_jp

ActiveX への JPEG 画像に対するハーeg

フトーン機能有効/無効

plugin_halftone_h2

ActiveX への H.264 動画に対するハー64

フトーン機能有効/無効－

パラメータ指定が無い場合、一括で設
定データ一覧を応答する

詳細は、”設定値一覧の取得”を参照ください。

POVCAM インターフェース仕様書 映像配信/クリップ操作編

42

6. 設定値一覧の取得
MethodAccess level

：GET
：Live

CGI 項目名
設定値一覧のパラメータ名URL

パラメータ値

説明
パラメータは必要ありません。

/cgi-bin/setdata

取得

応答データの説明は下記の通りです。
設定名称

値

説明

CAMTITLE

文字列

カメラ名称

IMAGESELECT

2m

撮像モード
2m:2M ピクセル

IMAGERATIO

16_9

画像比率
16_9:16:9 モード

IMAGEFPS

30

フレームレート
30:30fps

LIVESTREAM

h264

ライブ画面初期ストリーム選択

h264_2

h264:H264(1)jpeg

h264_2:H264(2)jpeg:JPEG(1)LIVEINT

1

JPEG(1)更新速度

5

1:1fps15(12.5)

5:5fps30(25)

15(12.5):15(12.5)fps
30(25):30(25)fps※()はシステム周波数が 50Hz の時

LIVEQUALBASE

1

JPEG(1)デフォルト画質
1:画質 1LIVESIZE

640

JPEG(1)画像解像度
640:640x360

LIVEQUAL

1

JPEG(1)画質

5

1:Fine5:Normal

STREAMMODE

1

動画配信方式1:H264

H264
H264_20

H264 配信 ON／OFF

1

0:OFF
1:ON

H264RTSPMODE

0

インターネットモード ON／OFF

H264RTSPMODE_2

1

0:OFF
1:ON

H264BWC

512,768,1024,1536,

1 クライアントあたりのビットレート

POVCAM インターフェース仕様書 映像配信/クリップ操作編

43

設定名称
H264BWC_2

H264BWCMIN

H264BWCMIN_2

NRH264BWC

値

説明2048,3072,4096,6144,

512(kbps)

8192,10240,12288,～

14336,16384,20480,

24576(kbps)

24576,32768,40960,5120～

051200(kbps)

512,768,1024,1536,

1 クライアントあたりの最小ビットレート

2048,3072,4096,6144,

512(kbps)

8192,10240,12288,～

14336,16384,20480,

24576(kbps)

24576,32768,40960,

～

51200

51200(kbps)

数値

配信停止しない 1 クライアントあたりのビットレート
単位[kbps]

NRH264BWC_2※setdata で取得する値は 1 クライアントあたりの最小ビットレートに依存します

H264SIZE

H264SIZE_2

640

H264(1)解像度

1280

640:640x360

1920

1280:1280x720

3840

1920:1920x1080

640

H264(2)解像度

1280

640:640x360
1280:1280x720

NRH264SIZE

640

配信停止しない H264(1)解像度

1280

640:640x360

1920

1280:1280x720

3840

1920:1920x1080
3840:3840x2160
setdata で取得する値は H264(1)の値に依存します

NRH264SIZE_2

640

配信停止しない H264(2)解像度

1280

640:640x360
1280:1280x720
setdata で取得する値は H264(2)の値に依存します

H264FPRIORITY
H264FPRIORITY_2

0

配信モード

1

0:Constant bit rate2

1:Frame rate
2:Best effort

H264NRFRAMERAT5

H264(1) フレームレートE

15(12.5)

5:5fps30(25)

15(12.5):15(12.5)fps

60(50)

30(25):30(25)fps
60(50):60(50)fps※() はシステム周波数が 50Hz の時

H264NRFRAMERAT5

H264(2) フレームレート

E_2

15(12.5)

5:5fps30(25)

15(12.5):15(12.5)fps
30(25):30(25)fps※() はシステム周波数が 50Hz の時

POVCAM インターフェース仕様書 映像配信/クリップ操作編

44

設定名称
H264QUAL
H264QUAL_2
NRH264QUAL

値
fine

H264 画質

low

fine:Image quality priority
low:Motion priority

normal1

リフレッシュ周期
1:1 秒

H264RINT_2
H264MTD

配信停止しない H264 画質
normal:標準

NRH264QUAL_2
H264RINT

説明

uni

H264 配信方式

uni_manual

uni:Unicast port(AUTO)

H264MTD_2

multi

uni_manual:Unicast port(MANUAL)

H264MLADD1

数値

multi:Multicast
H264(1) マルチキャストアドレス第 1 オクテット
224~239
H264MLADD2

数値

H264(1) マルチキャストアドレス第 2 オクテット
0~255

H264MLADD3

数値

H264(1) マルチキャストアドレス第 3 オクテット
0~255

H264MLADD4

数値

H264(1) マルチキャストアドレス第 4 オクテット
0~255

H264MLADD1_2

数値

H264(2) マルチキャストアドレス第 1 オクテット
224~239

H264MLADD2_2

数値

H264(2) マルチキャストアドレス第 2 オクテット
0~255

H264MLADD3_2

数値

H264(2) マルチキャストアドレス第 3 オクテット
0~255

H264MLADD4_2

数値

H264(2) マルチキャストアドレス第 4 オクテット
0~255

H264MLADD

IPv4 アドレス

H264 マルチキャストアドレス

数値

H264 マルチキャストポート

H264MLADD_2
H264MLPORT1024~50000

H264MLPORT_2
H264MLTTL

数値

1~254

H264MLTTL_2
H264UNIPORT

数値
数値

H264 ユニキャスト(音声用)ポート番号1024~50000(偶数のみ)

H264UNIPORT2_2
H264PROFILE

H264 ユニキャスト(映像用)ポート番号1024~50000(偶数のみ)

H264UNIPORT_2
H264UNIPORT2

H264 マルチキャスト TTL

0

H264 プロファイル
0:High profile

H264PROFILE_2
RTSPPORT

数値

RTSP サーバポート番号

H264MLAUTO

0

マルチキャスト配信を自動的に開始する
0:OFF

H264MLAUTO_2
AUDIO

in

音声設定

off

in:ON
off:OFFPOVCAM インターフェース仕様書 映像配信/クリップ操作編

45

設定名称
AUDIOSENS

値
middle説明
5.6 章参照

line_middle
sdi
PLUGIN_POWER

0

5.6 章参照

1
AUDIOMIC

external

5.6 章参照internal
AUDIOBITRATE

64

音声ビットレート96

64：64Kbps

128

96:96Kbps
128:128Kbps

AUDIOENC

2

エンコーダーの設定
2:AAC

PLUGIN_HALFTONE

0ActiveX への JPEG 画像に対するハーフトーン機能有
効/無効

_JPEG

0:無効
PLUGIN_HALFTONE
_H264

0

ActiveX への H264 に対するハーフトーン機能有効/無効
0:無効

POVCAM インターフェース仕様書 映像配信/クリップ操作編

46

7. HTTPS 制御に関する CGI 一覧
7.1. 情報の設定と証明書の取得
MethodAccess level：GET：AdminCGI 項目名URLHTTPS 自己証明書

https_self_signe

パラメータ名moded
HTTPS CA 証明書

https_signed

mode

HTTPS CRT 鍵履歴

https_crt_key

mode

パラメータ値
get_info

get_info: 情報確認

deletedelete: 削除

get_info

get_info: 情報確認

deletedelete: 削除

refreshCRT 鍵の処理の利用
HTTPS 接続方法

説明

refresh：更新
set_https

live

http

http :HTTP

https

https: HTTPS

https_port

1～65535HTTPS ポート番号

文字列

ホスト名

country

文字列

国名

state

文字列

都道府県名

locality

文字列

市町村名

organization

文字列

組織名

organization_

文字列

部署名

文字列

ホスト名

country

文字列

国名

state

文字列

都道府県名

locality

文字列

市町村名

organization

文字列

組織名

organization_

文字列

部署名

-

-

-

rsa_length

2048

2048: 2048bit

cgi_name

self_create

self_create：自己証明書作成状態

csr_create

csr_create：CSR 作成状態

ca_install

ca_install：CA 証明書インストール状態

key_create

key_create：CRT 鍵生成状態

HTTPS 自己証明書

https_creat_self_common_nam

生成signedeunit
HTTPS CSR 生成

https_creat_sign

common_nam

ed

e

unit
HTTPS CSR ダウンロ

/cgi-bin/https_doードwnload_csr

HTTPS CA 証明書イ

https_install_sign

ンストール

ed

HTTPS CRT 鍵生成

https_change_crt
_key

状態更新

renewalPOVCAM インターフェース仕様書 映像配信/クリップ操作編

47

7.2. 情報の取得
MethodAccess level

：GET
：Live

CGI 項目名URLHTTPS 設定情報取得/cgi-bin/get_httpsHTTPS CRT 鍵情報/cgi-bin/get_crt_k

取得

ey

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

HTTPS に関する設定は、WEB メニューから GUI で実施することを推奨します。
機種によっては HTTPS 機能がない場合があります。

POVCAM インターフェース仕様書 映像配信/クリップ操作編

48

8. SD カード記録に関する CGI 一覧
8.1. ビデオ記録モード設定
MethodAccess level：POST：AdminCGI 項目名URL

SD カード記録モード/cgi-bin/set_sdre

設定

c_mode

パラメータ名mode

パラメータ値

説明

mp4_2160_30p_50m

カメラヘッド

mp4_2160_24p_50m

を使用し、

mp4_2160_25p_50m

REC/PB(4K)の場合に設定可能です。

avchd_ps_1080_60p_28m
avchd_ph_1080_60i_21m
avchd_ph_1080_24p_21m
avchd_ha_1080_60i_17m
avchd_he_1080_60i_6m
avchd_ph_720_60p_21m
avchd_pm_720_60i_8m
avchd_ps_1080_50p_28m
avchd_ph_1080_50i_21m
avchd_ha_1080_50i_17m
avchd_he_1080_50i_6m
avchd_ph_720_50p_21m
avchd_pm_720_50i_8m
avchd_ph_1080_60i_21m_from_720

レコーダー

avchd_ha_1080_60i_17m_from_720

を単独で利

avchd_he_1080_60i_6m_from_720

用する場合

avchd_ph_1080_50i_21m_from_720に設定可能

avchd_ha_1080_50i_17m_from_720です。

avchd_he_1080_50i_6m_from_720

使用例）PS 1080/59.94p に設定
http://192.168.0.10/cgi-bin/set_sdrec_mode?mode=avchd_ps_1080_60p_28m

POVCAM インターフェース仕様書 映像配信/クリップ操作編

49

8.2. ビデオ記録モード取得
MethodAccess level

：GET
：Live

CGI 項目名URL

SD カード記録モード/cgi-bin/get_sdre

取得

c_mode

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

説明

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

説明

応答データは設定側を参照ください。

8.3. ビデオ記録メディアの設定
MethodAccess level：POST：AdminCGI 項目名

URL

ビデオ記録メディアの/cgi-bin/set_sdre

設定

c_targetdevicesd1

sd1: SD カードスロット 1

sd2

sd2: SD カードスロット 2

8.4. ビデオ記録メディアの取得
MethodAccess level：GET：AdminCGI 項目名

URL

ビデオ記録メディアの/cgi-bin/get_sdre

設定

c_target

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

説明

応答データは設定側を参照ください。

POVCAM インターフェース仕様書 映像配信/クリップ操作編

50

8.5. MP4 形式のビデオフォルダ名ファイル名の設定
MethodAccess level：POST：AdminCGI 項目名

URL

パラメータ名レコーダーID の設定/cgi-bin/set_recor

recorder_num

パラメータ値
0～16

説明
MP4 形式のビデオデータのフォルダ名を変更することができます。詳しくは取der_num

扱い説明書を参照ください。
クリップ番号リセット/cgi-bin/contentn

次に記録される MP4 クリップのフォル

um_reset

ダ番号が新規更新され、ファイル番号が 0001 から始まります。

詳しくは取扱説明書で各機能を確認ください。

8.6. MP4 形式のビデオフォルダ名ファイル名の取得
MethodAccess level：GET：AdminCGI 項目名

URL

レコーダーID の取得/cgi-bin/get_recor

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

説明

der_num

応答データは設定側を参照ください。

POVCAM インターフェース仕様書 映像配信/クリップ操作編

51

8.7. ビデオ記録の開始/終了制御
MethodAccess level

：GET
：Live

CGI 項目名
ビデオ記録の開始/終URL/cgi-bin/sdctrl

パラメータ名save

了制御

パラメータ値説明

start

start：記録開始

end

end：記録終了

使用例）SD カードへのビデオ記録を開始
http://192.168.0.10/cgi-bin/sdctrl?save=start使用例）SD カードへのビデオ記録を終了
http://192.168.0.10/cgi-bin/sdctrl?save=end

・記録開始/記録終了ともに数秒の処理時間が必要な場合があります。操作間隔を確保してください。
・正しく、記録開始/停止できたときは、” 204 No Content”を応答します。
・SD カード未挿入状態での記録開始指示などへは、” 500 Internal Server Error”を応答します。また、記録中の
記録開始指示についても、” 500 Internal Server Error”を応答します。
・記録中か否かの状態問い合わせは、9.1 章を参照ください。

POVCAM インターフェース仕様書 映像配信/クリップ操作編

52

9.SD カードの状態取得およびフォーマット(初期化)に関する CGI 一覧
9.1. SD カード関係の状態取得
：GET
：Live

MethodAccess level
CGI 項目名

URL

パラメータ名SD カード関係の状態/cgi-bin/get_state

パラメータ値説明

取得使用例）SD カード関係の状態取得(撮影モードのみ有効、再生モードやスタンバイ中は無効です)
http://192.168.0.10/cgi-bin/get_state

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

応答の値

説明

rec

off,onon:ビデオ記録中

pre_rec

off,onon:PRE-REC メニューON 中

rec_counter

00:00:00

記録経過時間ftp_send

off,onon:FTP 転送中

play

off

(固定値)

del_file

off,onon:クリップ(MP4/AVCHD)消去中

download

off,onon:クリップ(MP4/AVCHD)ダウンロード中

sd_format

off,onon:SD カードフォーマット(初期化)中

sd_insert

off,onon:SD カードスロット 1 挿入中

sd_repairoff,onon:SD カードスロット 1 修復中

sd_erroroff,onon:SD カードスロット 1 エラー中

sd_rem

*****SD カードスロット 1 のメディア残量(単位：Gbyte)

sd_org*****SD カードスロット 1 のメディア容量(単位：Gbyte)

sd2_insert

off,onon:SD カードスロット 2 挿入中

sd2_repair

off,onon:SD カードスロット 2 修復中

sd2_error

off,onon:SD カードスロット 2 エラー中

sd2_rem*****

SD カードスロット 2 のメディア残量(単位：Gbyte)

sd2_org*****

SD カードスロット 2 のメディア容量(単位：Gbyte)

本 CGI を定期ポーリングすることで、記録状態やカウンター情報を取得することが可能です。ポーリング時間は1000msec 以上開けることを推奨します。

POVCAM インターフェース仕様書 映像配信/クリップ操作編

53

9.2. SD カードのフォーマット(初期化)制御
MethodAccess level：POST：AdminCGI 項目名URL

SD カードフォーマット

/cgi-bin/sdcard

パラメータ名cmd

パラメータ値
format説明スロット 1 の SD カードをフォーマット(初期化)format2

スロット 2 の SD カードをフォーマット(初期化)使用例）スロット 1 の SD カードをフォーマット(初期化)開始
http://192.168.0.10/cgi-bin/sdcard?cmd=format※SD カード使用中にフォーマットすると、本文中に"ErrorNo=3"が返ります。この場合は実行できません。
※SD カードのフォーマット(初期化)は、カードの種類や状態によっては、SD カードの完全なイレースから実施する場合があります。この場合は最大 120 秒程度処理時間が必要です。/cgi-bin/get_progress で 完了したことを確認してから次コマンドを発行してください。

9.3. SD カードのフォーマット(初期化)進捗確認
MethodAccess level：GET：AdminCGI 項目名
進捗確認

URL/cgi-bin/get_prog

パラメータ名type

パラメータ値
formatress

説明SD メモリーカードのフォーマットの進捗
取得

応答データは下記の通りです。
progress=xxx※xxx に入る値
prepare:準備中
exec:処理実行中
finish:完了
cancel:中止処理中
error:エラー終了

POVCAM インターフェース仕様書 映像配信/クリップ操作編

54

10.記録済みクリップ(MP4/AVCHD)に関する CGI 一覧
10.1. クリップ(MP4/AVCHD)リスト検索
MethodAccess level

：GET
：Live

CGI 項目名

URL

パラメータ名SD カードのクリップリ/cgi-bin/get_clip_lmaxmatches

スト検索

ist

パラメータ値
1~15

説明取得するリストの上限数
※省略可能

index

数値

リスト検索開始位置

devicesd1

sd1:スロット 1 の SD カード

sd2

sd2:スロット 2 の SD カード

1~65535※省略時は sd1 と同等
formatmp4

mp4:MP4 形式

avchd

avchd:AVCHD 形式

使用例）スロット 2 の SD カードより、AVCHD 形式のリストを取得
http://192.168.0.10/cgi-bin/get_clip_list?index=1&device=sd2&format=avchd

応答データは下記の通りです。
no,filename,mm/dd/yyyy hh:mm:ss,duration[CR][LF]・・・
ClipfileNum=数値(取得したリスト数)[CR][LF]
ClipfileALLNum=数値(ファイル総数)[CR][LF]
list_id=数値

応答データ例は下記の通りです。
no,filename,mm/dd/yyyy hh:mm:ss,duration
1,S1AA001000000160,06/26/2017 20:12:02,00:00:12
2,S1AA001000000260,06/26/2017 20:13:10,00:00:02
ClipfileNum=2
ClipfileALLNum=2
list_id=5777
なお、mm/dd/yyyy hh:mm:ss,duration は、該当クリップの記録開始日時と記録経過時間を示します。
最終行の list_id は、取得したファイルリストに対するユニーク値です。消去/ダウンロード/FTP 転送で利用します。

POVCAM インターフェース仕様書 映像配信/クリップ操作編

55

10.2. クリップ(MP4/AVCHD)消去
MethodAccess level

：GET
：Live

CGI 項目名
保存データの消去

URL/cgi-bin/del_clip_f

パラメータ名fileno

パラメータ値
数値

説明/cgi-bin/get_clip_list
で取得したファイル No

ile※最大 50 個まで指定可能
list_id数値/cgi-bin/get_clip_list
で取得したリスト ID

使用例）ファイル No.1,2 を消去する
http://192.168.0.10/cgi-bin/del_clip_file?fileno=1,2&list_id=5777

POVCAM インターフェース仕様書 映像配信/クリップ操作編

56

10.3. クリップ(MP4/AVCHD)のダウンロード制御
MethodAccess level

：GET
：Live

CGI 項目名

URL

ファイル指定によるダ/cgi-bin/get_clip_

ウンロード

file

パラメータ名filename

パラメータ値
文字列

説明/cgi-bin/get_clip_list
で取得したファイル名

list_id数値/cgi-bin/get_clip_list
で取得したリスト ID

使用例）ファイル 000120150101 をダウンロードする
http://192.168.0.10/cgi-bin/get_clip_file?filename=S1AA001000000160&list_id=5799

10.4. クリップ(MP4/AVCHD)のダウンロードシーケンス

ダウンロード時、/cgi-bin/get_clip_list で取得したファイル名( ex . S0M40010000001A0 ) をデフォルトのファイ
ル名として応答します。ダウンロード完了後に、/cgi-bin/get_clip_list で取得した日付等にリネームすることをお勧めします。

POVCAM インターフェース仕様書 映像配信/クリップ操作編

57

11. FTP 制御に関する CGI 一覧
11.1. FTP 概要
FTP サーバーと、メモリーカード・ポータブルレコーダーおよび専用オプションのコンパクト・カメラヘッドの関係は以下のとおりです。本書では、外部制御用のパソコン等を利用したケースを記載します。

・メモリーカード・ポータブルレコーダーおよび専用オプションのコンパクト・カメラヘッドは FTP サーバーにはなれません。送出専用です。

POVCAM インターフェース仕様書 映像配信/クリップ操作編

58

11.2. 転送先 FTP サーバー設定
MethodAccess level：POST：AdminCGI 項目名FTP サーバﾞ設定

URL

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

説明/cgi-bin/set_ftp

server_addr*.*.*.*形式*.*.*.*形式

username

文字列

文字列(半角英数 32 文字以内)

password

文字列

文字列(半角英数 32 文字以内)

port_num

1～65535

1～65535

mode

activeactive：active モード

passivepassive：passive モード

文字列

FTP サーバーへログイン後、ユーザー

dirnameのルートディレクトリに準備するフォル
ダ名(文字列(256 文字以内))※入力可能文字：全角、半角記号（「"」、「&」、「:」）※11.7 章を参照してください

使用例）FTP サーバー”192.168.0.121”を設定。FTP サーバーの ID/PASS は user1/password として、フォルダはuser1_dir とする。
http://192.168.0.10/cgi-bin/set_ftp?server_addr=192.168.0.121&username=user1&password=passwor
d&port_num=21&mode=active&dirname=user1_dir

11.3. FTP サーバー情報取得
MethodAccess level：GET：AdminCGI 項目名URL

FTP サーバー設定情/cgi-bin/get_ftp

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

説明

報取得

応答データは下記の通りです。
server_addr=*.*.*.*形式
dirname=文字列
username=文字列
port_num=数値
mode=active/passive

POVCAM インターフェース仕様書 映像配信/クリップ操作編

59

11.4. リスト付転送開始指示/キャンセル
MethodAccess level：POST/GET：AdminCGI 項目名

URL

リスト付転送開始指示/cgi-bin/send_ftp

パラメータ名fileno

パラメータ値
数値

説明/cgi-bin/get_clip_list
で取得したファイル No

server※最大 50 個まで指定可能
複数ファイル指定する場合は、ファイル
No の数字間を "," で区切る
select_type

filenofileno:ファイル No 指定

allall:全部指定※all を指定した場合は、転送するファ
イル No の指定はしないこと

list_id数値/cgi-bin/get_clip_list
で取得したリスト ID

FTP サーバーへの転/cgi-bin/cancel_s

送キャンセル

end_ftpserver※/cgi-bin/get_clip_list を利用する必要があります。10.1 章を参照してください。

使用例）ファイル No 指定で No.1 のファイルを転送
http://192.168.0.10/cgi-bin/send_ftpserver?fileno=1&select_type=fileno&list_id=100
使用例）ファイル No 指定で No.2,No.3 のファイルを転送
http://192.168.0.10/cgi-bin/send_ftpserver?fileno=2,3&select_type=fileno&list_id=100
使用例）ファイル全部を転送
http://192.168.0.10/cgi-bin/send_ftpserver?select_type=all&list_id=100
使用例）転送をキャンセル
http://192.168.0.10/cgi-bin/cancel_send_ftpserver

POVCAM インターフェース仕様書 映像配信/クリップ操作編

60

11.5. 転送進捗確認
MethodAccess level：GET：AdminCGI 項目名
転送進捗確認URL/cgi-bin/get_prog

パラメータ名type

パラメータ値
send_ftp

説明
FTP サーバー転送の進捗取得

ress

応答データは下記の通りです。
progress=xxx
rate=数値(%)※xxx に入る値
prepare:準備中
exec:処理実行中
finish:完了
cancel:中止処理中
error:エラー終了※rate は進捗率を表す

POVCAM インターフェース仕様書 映像配信/クリップ操作編

61

11.6. FTP 制御シーケンス

POVCAM インターフェース仕様書 映像配信/クリップ操作編

62

11.7. FTP サーバー側のフォルダ設定について
カメラは、FTP サーバーへの転送開始指示( /cgi-bin/send_ftpserver ) 毎に、転送先の FTP サーバー内部の指定フォルダ(FTP サーバﾞ設定での dirname)以下に、SD カード内部のクリップ(MP4/AVCHD)ファイルを転送します。

FTP サーバー側で決定されるユーザーホームフォルダ
カメラ側で設定する指定フォルダ( FTP サーバﾞ設定での dirname )AW000001
1 回目の FTP 転送
DCIM/AVCHD

AW000002

DCIM/AVCHD

2 回目の FTP 転送

FTP サーバー側に、カメラ側で設定する指定フォルダ( FTP サーバﾞ設定での dirname ) が存在しない場合は転送開始のタイミングで、カメラが自動的に新規生成します**。
さらに、指定フォルダ以下には、”AW”から開始する連番フォルダを作成し、その中に DCIM/AVCHD から始まる
SD カードフォルダイメージを転送します。
転送開始時に“AW”から始まる連番フォルダが存在している場合は、自動的に数値を+1 した新規フォルダを生成します。
なお、AW999999 フォルダが存在している場合は、FTP 転送開始できません。

**noteFTP 転送に失敗する場合、カメラ側で設定する指定フォルダ( FTP サーバﾞ設定での dirname )が存在していない場合があります。FTP サーバー側で事前にフォルダを作成しておくことをおすすめします。

POVCAM インターフェース仕様書 映像配信/クリップ操作編

63

12.RTSP での制御について
メモリーカード・ポータブルレコーダーおよび専用オプションのコンパクト・カメラヘッドは、一般的な RTSP プロトコ
ルにも対応しています。本章では、RTSP での活用方法を例示します。ご使用になる場合には、お客様に
RTSP/RTP/RTCP の知識が必要になります。

12.1. rtsp リクエスト用の URL について
メモリーカード・ポータブルレコーダーおよび専用オプションのコンパクト・カメラヘッドの RTSP リクエスト用の URLは以下の通りです。
Request URL
Description
カメラの WEB メニューH264(1)で設定した映像を要求でrtsp://<cam_ip>/mediainput/h264/stream_1
きます。
カメラの WEB メニューH264(2)で設定した映像を要求でrtsp://<cam_ip>/mediainput/h264/stream_2
きます。
カメラ(RTSP Server)側の RTSP ポートは、工場出荷時では 554 です。変更が必要な場合は、cgi-bin/set_rtsp(POST コマンド)を使用してください。

メモリーカード・ポータブルレコーダーおよび専用オプションのコンパクト・カメラヘッドの WEB メニューにある”H.264 transmission”および、”Audio Transmission”の関係は以下のとおりです。
Audio Transmission
ONOFF
映像/音声ともに利用可能
映像のみ利用可能※DESCRIBE に対して、※DESCRIBE に対して、
ON
映像+音声の SDP 情報を応答
映像の SDP 情報のみ応答
H.264
transmission
OFF

映像/音声ともに利用不可※SETUP に対して 503 を応答”Audio Transmission”が ON の場合、DESCRIBE 情報に Audio 情報を付与する形式で、カメラが応答します。必要に応じて、SETUP 指示を行うことで、音声の配信が可能です。逆に SETUP を行わない場合は、映像のみの配信が可能です。また、カメラの WEB メニューにある”Audio”が OFF の場合もしくは、”Audio IN 端子”に何も接続されていない場合は、無音での配信となります。
本書では”H.264 transmission”および、”Audio Transmission”は ON の状態として記述します。

POVCAM インターフェース仕様書 映像配信/クリップ操作編

64

12.2. rtsp メソッドについて
カメラでサポートしている RTSP メソッドは以下の通りです。
Supported Method
OPTIONSDESCRIBE
SETUP
PLAY
PAUSE
GET_PARAMETERTEARDOWN

Description
対応コマンドのチェック
セッション情報および Audio サポート有無の取得
セッションの初期化および、相互ポート情報の交換
転送開始
転送中断
※送信を停止します、マルチキャスト時は無視します。
セッションパラメータの取得※キープアライブとして動作します。
転送終了/セッション終了

SET_PARAMETER には対応していません。501 を応答します。

POVCAM インターフェース仕様書 映像配信/クリップ操作編

65

13. RTSP でのストリームの取得について
カメラでサポートしている RTSP での通信方式は以下の通りです。いずれの方式を使用しても、RTSP の初期ネゴ
シエーションには TCP 通信(カメラ側の待ち受けは工場出荷時 554)を使用します。
1.UDP Unicast
・カメラ 1 台に対して、1 台のクライアントへ映像/音声を配信する際に利用します。
・複数のクライアントへの配信にも対応していますが、接続毎にネットワーク帯域が必要です。
2.UDP Multicast
・カメラ 1 台に対して、複数のクライアントへ同時に映像/音声を配信する際に利用します。
・複数のクライアントへの配信する際も、カメラ側のネットワーク帯域が増加しません。
・別途マルチキャストに対応してルーターが必要です。
3.TCP Unicast
・カメラ 1 台に対して、1 台のクライアントへ映像/音声を配信する際に利用します。
・RTP/UDP で通信する映像および音声データを TCP で配信できます。

13.1 UDP Unicast
カメラ側の事前準備としては、WEB メニューで以下の設定が必要です。
・H264(X)/Transmission type を Unicast(AUTO)に設定する映像および音声ストリームの配信時のポート番号は、以下で決定されます。
・client_port (クライアント側で受信するポート):
RTSP”SETUP”シーケンスで、クライアントがカメラへ明示的に指示する。
※ポート番号の決定方法は、クライアントによって異なり、ランダム設定や専用メニューが存在します。
・server_port (カメラが送出するポート):
RTSP”SETUP”シーケンスの応答で、カメラがクライアントへ応答する。
※ポート番号はランダムに決定されます。
なお、client_port を強制的に固定したい場合は、以下の WEB メニュー設定で可能です・H264(X)/Transmission type を Unicast(MANUAL)に設定する・Unicast port(Image)/Unicast port(Audio)を設定する※ただし、RTSP”SETUP”シーケンスで、クライアントがカメラへ明示的に指示した内容を無視することになるので、通常は使用しません。
UDP Unicast 方式での、映像および音声ストリームの取得方法を例示します。

POVCAM インターフェース仕様書 映像配信/クリップ操作編

66

UDP Unicast Sequence

POVCAM インターフェース仕様書 映像配信/クリップ操作編

67

UDP Unicast Packets

POVCAM インターフェース仕様書 映像配信/クリップ操作編

(1/2)

68

UDP Unicast Packets

POVCAM インターフェース仕様書 映像配信/クリップ操作編

(2/2)

69

13.2 UDP Multicast
カメラ側の事前準備としては、WEB メニューで以下の設定が必要です。
・H264(X)/Transmission type を Multicast に設定する
・H264(X)/Multicast address を設定する(H264(1)の工場出荷時は 239.192.0.20)
・H264(X)/Multicast port を設定する(H264(1)の工場出荷時は 37004)

映像および音声ストリームの配信時のポート番号およびマルチキャストアドレスは、カメラの WEB メニュー値に依存し、クライアント側からの指示は無視されます。

UDP Multicast 方式での、映像および音声ストリームの取得方法を例示します。

POVCAM インターフェース仕様書 映像配信/クリップ操作編

70

UDP Multicast Sequence

POVCAM インターフェース仕様書 映像配信/クリップ操作編

71

UDP Multicast Packets

POVCAM インターフェース仕様書 映像配信/クリップ操作編

(1/2)

72

UDP Multicast Packets

POVCAM インターフェース仕様書 映像配信/クリップ操作編

(2/2)

73

13.3 TCP Unicast
カメラ側の事前準備としては、WEB メニューで以下の設定が必要です。
・H264(X)/Transmission type を Unicast(AUTO)に設定する映像および音声ストリームの配信時のポート番号は、以下で決定されます。
・client_port (クライアント側で受信するポート):
RTSP”PLAY”シーケンスで使用したクライアントの送出側ポートが、クライアント側の受信ポートになります。
※ポート番号の決定方法は、クライアントによって異なり、ランダム設定や専用メニューが存在します。
・server_port (カメラが送出するポート):
RTSP 待ち受けポート(工場出荷時 554)が使用されます。
なお、クライアント側から指定したインターリーブヘッダについては、カメラ側は無視し、新しいインターリーブヘッダを発行します。
TCP Unicast 方式での、映像および音声ストリームの取得方法を例示します。

POVCAM インターフェース仕様書 映像配信/クリップ操作編

74

TCP Unicast Sequence

POVCAM インターフェース仕様書 映像配信/クリップ操作編

75

TCP Unicast Packets 1/2

POVCAM インターフェース仕様書 映像配信/クリップ操作編

76

TCP Unicast Packets 2/2

POVCAM インターフェース仕様書 映像配信/クリップ操作編

77

13.4 rtpmap Attribute について
RTSP”DESCRIBE”要求に対する”rtpmap”の応答は以下のとおりです。
Codec
H.264
AAC

rtpmap Attribute Value
a=rtpmap:98 H264/90000
a=rtpmap:99 mpeg4-generic/48000/2

映像および音声ともに、ビットレート等には関係なく上記の値を使用します。

POVCAM インターフェース仕様書 映像配信/クリップ操作編

78

14. RTCP での制御について
カメラは、RTCP を使用した回線状況に応じた動的なビットレートおよびフレームレートの制御にも対応しています。
前提条件として RTCP/SR(Sender Report)および、RTCP/RR(Receiver Report)に対応したクライアントが必要です。
カメラ側の事前準備としては、WEB メニューで以下の設定が必要です。
・H264(X)/Transmission priority を Best effort に設定する※Frame rate(工場出荷設時)や、Constant bit rate では、RTCP/SR を送信し、RTCP/RR を受信しますが、ビットレートおよびフレームレートの制御には使用しません。
・H264(X)/Image quality を、Motion priority もしくは Image quality priority から選択する
Motion priority : 動き優先モードです。ビットレートを積極的に変更して対応します。
Image quality priority : 画質優先モードです。フレームレートを積極的に変更します。

RTCP 制御時のシーケンスを例示します。

なお、カメラでは、RTCP/SR を 5 秒毎に送信し、RTCP/RR のうち VIDEO に関係するもののみ使用しています。

POVCAM インターフェース仕様書 映像配信/クリップ操作編

79

15. RTP/データフォーマットについて
15.1. RTP ヘッダーフォーマット
Bit

0.

8.

Byte

2

1

1

0

V

P

X

4

1
CC

16.
7

24.

8

M

PT

8
Sequence number

4

Timestamp

8

SSRC (Synchronization Source Identifier)

12

Defined by profile

16

Extension length
Additional Information (1)Additional Information (N)Parameter namelength(Bit)

Values and comments

V (Version)

2

2 (fixed)

P (Padding)1

0 (fixed)

X (Extension)

1

0: false , 1: true

CC (CSRC Count)

40 (fixed)

M (Marker)

1

In case of the last RTP packet of a picture, this value is set to 1

PT (Payload Type)

7

Sequence number

16

Timestamp

32

Time stamp

SSRC

32

0x0000 0000 (fixed)

CSRC

0

UnusedDefined by profile(*)

16

0 (fixed)

Extension length(*)

16

Length of the Header Extension (Unit of 32bit word)

98 (fixed for H.264)
99 (fixed for AAC)
The value in which one increment is done in each RTP packet is set.
An initial value is generated at random.

meta information(Additional
Information) (*)

POVCAM インターフェース仕様書 映像配信/クリップ操作編

80

15.2. H.264/ES データとの関係
H.264 の ES データと RTP パケットの構造は以下の通りです。
Parameter set
AU

PPS

SEI

NALh

#1

Ether/IPh/UDPh

RTPh

AU

#2

Ether/IPh/UDPh

RTPh SPS#3

Ether/IPh/UDPh

RTPh PPS#4Ether/IPh/UDPh

RTPh

SEI

#5

Ether/IPh/UDPh

RTPh

FUi

FUh

RBSP

#6

Ether/IPh/UDPh

RTPh

FUi

FUh

RBSP

#N

Ether/IPh/UDPh

RTPh

FUi

FUh

Structure of ES data

RTP packet

SPS

Encoded data
RBSP

(FU-A)

RBSP[Note]NALh:NAL header(1Byte)Fui:FU identifier(1Byte)Fuh:FU header (1Byte)

Ether/IPh/UDPh:Ether/IP header/UDP header

RTPh:RTP header

POVCAM インターフェース仕様書 映像配信/クリップ操作編

81

15.3. H.264 Syntax
カメラでは、解像度/フレームレートに依存して、使用する Codec 情報が変化します。
59.94Hz 設定時は、以下のとおりです。
Resolution / Frame rate
640x360/5p,15p,30p
1280x720/5p,15p,30p,60p
1920x1080/5p,15p,30p

Codec Info
H.264/High プロファイル(B フレームなし/CAVLC)GOP 間隔約 1 秒
H.264/High プロファイル(B フレームなし/CABAC)
GOP 間隔約 1 秒
H.264/High プロファイル(B フレームなし/CABAC)
GOP 間隔約 0.5 秒
H.264/High プロファイル(B フレームあり/CABAC)
GOP 間隔約 0.5 秒

1920x1080/60p
3840x2160/5p,15p
3840x2160/30p

15.4. Audio データフォーマット
音声 ES データと RTP パケットの構造は音声圧縮方式によって異なります。
音声圧縮方式が AAC の場合：
RTP ヘッダと音声データの間に、AU ヘッダー(2byte)が挿入されて送信されます。

RTP Header

AU Header

ES(AUDIO data)

POVCAM インターフェース仕様書 映像配信/クリップ操作編

82

Memo:POVCAM インターフェース仕様書 映像配信/クリップ操作編

83