252 صفحه
IEC 62676:2013-Video surveillance systems for use in security applications – Part 2-2: Video transmission protocols – IP interoperability implementation based on HTTP and REST services
1316 صفحه فایل pdf
IEC 62676:2013-Video surveillance systems for use in security applications – Part 2-3: Video transmission protocols – IP interoperability implementation based on Web services
مطالب ارائه شده در این استاندارد:
INTRODUCTION ................................................................................................................... 23
1 Scope ............................................................................................................................. 24
2 Normative references ..................................................................................................... 26
3 Terms, definitions and abbreviations .............................................................................. 29
3.1 Terms and definitions ............................................................................................ 29
3.2 Abbreviations ........................................................................................................ 32
4 Overview ........................................................................................................................ 34
4.1 Web services ......................................................................................................... 34
4.2 IP configuration ..................................................................................................... 35
4.3 Device discovery ................................................................................................... 35
4.4 Device types ......................................................................................................... 36
4.5 Device management .............................................................................................. 36
4.5.1 Capabilities ............................................................................................... 36
4.5.2 Network ..................................................................................................... 37
4.5.3 System ...................................................................................................... 37
4.5.4 Retrieval of system information .................................................................. 37
4.5.5 Firmware upgrade ..................................................................................... 38
4.5.6 System restore .......................................................................................... 38
4.5.7 Security ..................................................................................................... 38
4.6 DeviceIO ............................................................................................................... 38
4.7 Imaging configuration ............................................................................................ 39
4.8 Media configuration ............................................................................................... 39
4.8.1 General ..................................................................................................... 39
4.8.2 Media profiles ............................................................................................ 39
4.9 Real-time streaming .............................................................................................. 43
4.10 Event handling ...................................................................................................... 44
4.11 PTZ control ........................................................................................................... 44
4.12 Video analytics ...................................................................................................... 45
4.13 Analytics device .................................................................................................... 47
4.14 Display .................................................................................................................. 47
4.15 Receiver ................................................................................................................ 47
4.15.1 General ..................................................................................................... 47
4.15.2 Synchronization points .............................................................................. 48
4.16 Storage ................................................................................................................. 48
4.16.1 Storage model ........................................................................................... 48
4.16.2 Recording .................................................................................................. 49
4.16.3 Search ....................................................................................................... 50
4.16.4 Replay ....................................................................................................... 50
4.17 Security ................................................................................................................. 50
5 Web Services framework ................................................................................................ 51
5.1 Services overview ................................................................................................. 51
5.1.1 General ..................................................................................................... 51
5.1.2 Services requirements ............................................................................... 52
5.2 WSDL overview ..................................................................................................... 52
5.3 Namespaces ......................................................................................................... 53 –
5.4 Types .................................................................................................................... 55
5.5 Messages .............................................................................................................. 55
5.6 Operations ............................................................................................................ 56
One-5.6.1 way operation type ............................................................................. 57
5.6.2 Request-response operation type .............................................................. 58
5.7 Port types .............................................................................................................. 58
5.8 Binding .................................................................................................................. 58
5.9 Ports ..................................................................................................................... 58
5.10 Services ................................................................................................................ 58
5.11 Error handling ....................................................................................................... 58
5.11.1 Protocol errors ........................................................................................... 59
5.11.2 SOAP errors .............................................................................................. 59
5.12 Security ................................................................................................................. 62
5.12.1 User-based access control ........................................................................ 62
5.12.2 User token profile ...................................................................................... 63
6 IP configuration .............................................................................................................. 64
7 Device discovery ............................................................................................................ 65
7.1 General ................................................................................................................. 65
7.2 Modes of operation ................................................................................................ 65
7.3 Discovery definitions ............................................................................................. 66
7.3.1 Endpoint reference .................................................................................... 66
7.3.2 Hello .......................................................................................................... 66
7.3.3 Probe and probe match ............................................................................. 68
7.3.4 Resolve and resolve match ........................................................................ 68
7.3.5 Bye ............................................................................................................ 68
7.3.6 SOAP fault messages ................................................................................ 69
7.4 Remote discovery extensions ................................................................................ 69
7.4.1 Network scenarios ..................................................................................... 69
7.4.2 Discover proxy (DP) .................................................................................. 71
7.4.3 Remote Hello and Probe behaviour ........................................................... 72
7.4.4 Client behaviour ........................................................................................ 73
7.4.5 Security ..................................................................................................... 73
8 Device management ....................................................................................................... 74
8.1 Capabilities ........................................................................................................... 74
8.1.1 Get WSDL URL ......................................................................................... 74
8.1.2 Capability exchange .................................................................................. 75
8.2 Network ................................................................................................................. 78
8.2.1 Get hostname ............................................................................................ 78
8.2.2 Set hostname ............................................................................................ 78
8.2.3 Get DNS settings ....................................................................................... 79
8.2.4 Set DNS settings ....................................................................................... 80
8.2.5 Get NTP settings ....................................................................................... 81
8.2.6 Set NTP settings ....................................................................................... 82
8.2.7 Get dynamic DNS settings ......................................................................... 83
8.2.8 Set dynamic DNS settings ......................................................................... 84
8.2.9 Get network interface configuration ........................................................... 85
8.2.10 Set network interface configuration ............................................................ 85
8.2.11 Get network protocols ................................................................................ 87
8.2.12 Set network protocols ................................................................................ 88
8.2.13 Get default gateway ................................................................................... 88
8.2.14 Set default gateway ................................................................................... 89
8.2.15 Get zero configuration ............................................................................... 90
8.2.16 Set zero configuration ................................................................................ 90
8.2.17 Get IP address filter ................................................................................... 91
8.2.18 Set IP address filter ................................................................................... 92
8.2.19 Add an IP filter address ............................................................................. 92
8.2.20 Remove an IP filter address....................................................................... 93
8.2.21 IEEE 802.11 configuration ......................................................................... 94
8.3 System .................................................................................................................. 99
8.3.1 Device Information..................................................................................... 99
8.3.2 Get System URIs ..................................................................................... 100
8.3.3 Backup .................................................................................................... 101
8.3.4 Restore ................................................................................................... 101
8.3.5 Start system restore ................................................................................ 102
8.3.6 Get system date and time ........................................................................ 103
8.3.7 Set system date and time ........................................................................ 104
8.3.8 Factory default ........................................................................................ 105
8.3.9 Firmware upgrade ................................................................................... 106
8.3.10 Start firmware upgrade ............................................................................ 107
8.3.11 Get system logs ....................................................................................... 108
8.3.12 Get support information ........................................................................... 109
8.3.13 Reboot .................................................................................................... 110
8.3.14 Get scope parameters ............................................................................. 110
8.3.15 Set scope parameters .............................................................................. 111
8.3.16 Add scope parameters ............................................................................. 112
8.3.17 Remove scope parameters ...................................................................... 113
8.3.18 Get discovery mode ................................................................................. 113
8.3.19 Set discovery mode ................................................................................. 114
8.3.20 Get remote discovery mode ..................................................................... 114
8.3.21 Set remote discovery mode ..................................................................... 115
8.3.22 Get remote DP addresses ........................................................................ 115
8.3.23 Set remote DP addresses ........................................................................ 116
8.4 Security ............................................................................................................... 116
8.4.1 Get access policy .................................................................................... 116
8.4.2 Set access policy ..................................................................................... 117
8.4.3 Get users................................................................................................. 117
8.4.4 Create users ............................................................................................ 118
8.4.5 Delete users ............................................................................................ 119
8.4.6 Set users settings .................................................................................... 120
8.4.7 IEEE 802.1X configuration ....................................................................... 121
8.4.8 Create self-signed certificate ................................................................... 126
8.4.9 Get certificates ........................................................................................ 127
8.4.10 Get CA certificates .................................................................................. 128
8.4.11 Get certificate status................................................................................ 128
8.4.12 Set certificate status ................................................................................ 129
8.4.13 Get certificate request ............................................................................. 129
8.4.14 Get client certificate status ...................................................................... 130
8.4.15 Set client certificate status ....................................................................... 131
Load device c 8.4.16 ertificate ............................................................................. 131
8.4.17 Load device certificates in conjunction with its private key ....................... 132
8.4.18 Get certificate information request ........................................................... 133
8.4.19 Load CA certificates ................................................................................ 134
8.4.20 Delete certificate ..................................................................................... 135
8.4.21 Get remote user ...................................................................................... 136
8.4.22 Set remote user ....................................................................................... 137
8.4.23 Get endpoint reference ............................................................................ 138
8.5 Input/Output (I/O) ................................................................................................ 138
8.5.1 Get relay outputs ..................................................................................... 139
8.5.2 Set relay output settings .......................................................................... 139
8.5.3 Trigger relay output ................................................................................. 140
8.5.4 Auxiliary operation ................................................................................... 141
8.6 Service specific fault codes ................................................................................. 142
9 Device IO Service ......................................................................................................... 148
9.1 VideoOutputs ...................................................................................................... 148
9.1.1 General ................................................................................................... 148
9.1.2 GetVideoOutputs ..................................................................................... 148
9.2 VideoOutputConfiguration ................................................................................... 149
9.2.1 GetVideoOutputConfiguration .................................................................. 149
9.2.2 SetVideoOutputConfiguration .................................................................. 149
9.2.3 GetVideoOutputConfigurationOptions ...................................................... 150
9.3 VideoSources ...................................................................................................... 151
9.3.1 General ................................................................................................... 151
9.3.2 GetVideoSources..................................................................................... 151
9.4 VideoSourceConfiguration ................................................................................... 152
9.4.1 GetVideoSourceConfiguration.................................................................. 152
9.4.2 SetVideoSourceConfiguration .................................................................. 153
9.4.3 GetVideoSourceConfigurationOptions ...................................................... 153
9.5 AudioOutputs ...................................................................................................... 154
9.5.1 General ................................................................................................... 154
9.5.2 GetAudioOutputs ..................................................................................... 154
9.6 AudioOutputConfiguration ................................................................................... 155
9.6.1 GetAudioOutputConfiguration .................................................................. 155
9.6.2 SetAudioOutputConfiguration .................................................................. 156
9.6.3 GetAudioOutputConfigurationOptions ...................................................... 156
9.7 AudioSources ...................................................................................................... 157
9.7.1 General ................................................................................................... 157
9.7.2 GetAudioSources..................................................................................... 157
9.8 AudioSourceConfiguration ................................................................................... 158
9.8.1 GetAudioSourceConfiguration.................................................................. 158
9.8.2 SetAudioSourceConfiguration .................................................................. 159
9.8.3 GetAudioSourceConfigurationOptions ...................................................... 159
9.9 Relay outputs ...................................................................................................... 160
9.9.1 Get relay outputs ..................................................................................... 160
9.9.2 Set relay output settings .......................................................................... 161
9.9.3 Trigger relay output ................................................................................. 162
9.10 Service specific fault codes ................................................................................. 163
10 Imaging configuration ................................................................................................... 164
10.1 Imaging settings .................................................................................................. 164
Get 10.1.1 imaging settings ................................................................................ 165
10.1.2 Set imaging settings ................................................................................ 166
10.1.3 Get options .............................................................................................. 167
10.1.4 Move ....................................................................................................... 168
10.1.5 Get move options .................................................................................... 169
10.1.6 Stop ........................................................................................................ 170
10.1.7 Get imaging status................................................................................... 171
10.2 Service specific fault codes ................................................................................. 172
11 Media configuration ...................................................................................................... 173
11.1 Audio and video codecs....................................................................................... 173
11.2 Media profile ....................................................................................................... 173
11.2.1 Create media profile ................................................................................ 174
11.2.2 Get media profiles ................................................................................... 175
11.2.3 Get media profile ..................................................................................... 176
11.2.4 Add video source configuration to a profile .............................................. 177
11.2.5 Add video encoder configuration to a profile ............................................ 177
11.2.6 Add audio source configuration to a profile .............................................. 178
11.2.7 Add audio encoder configuration to a profile ............................................ 179
11.2.8 Add PTZ configuration to a profile ........................................................... 180
11.2.9 Add video analytics configuration to a profile ........................................... 181
11.2.10 Add metadata configuration to a profile ................................................... 182
11.2.11 Add audio output configuration ................................................................ 183
11.2.12 Add audio decoder configuration ............................................................. 184
11.2.13 Remove video source configuration from a profile .................................... 185
11.2.14 Remove video encoder configuration from a profile ................................. 186
11.2.15 Remove audio source configuration from a profile ................................... 187
11.2.16 Remove audio encoder configuration from a profile ................................. 188
11.2.17 Remove PTZ configuration from a profile ................................................. 189
11.2.18 Remove video analytics configuration from a profile ................................ 190
11.2.19 Remove metadata configuration from a profile ......................................... 191
11.2.20 Remove audio output configuration .......................................................... 192
11.2.21 Remove audio decoder configuration ....................................................... 193
11.2.22 Delete media profile ................................................................................ 194
11.3 Video source ....................................................................................................... 195
11.3.1 General ................................................................................................... 195
11.3.2 GetVideoSources..................................................................................... 195
11.4 Video source configuration .................................................................................. 196
11.4.1 Get video source configurations............................................................... 196
11.4.2 Get video source configuration ................................................................ 197
11.4.3 Get compatible video source configurations ............................................. 197
11.4.4 Get video source configuration options .................................................... 198
11.4.5 Modify a video source configuration ......................................................... 199
11.5 Video encoder configuration ................................................................................ 200
11.5.1 Get video encoder configurations ............................................................ 201
11.5.2 Get video encoder configuration .............................................................. 201
11.5.3 Get compatible video encoder configurations ........................................... 202
11.5.4 Get video encoder configuration options .................................................. 203
11.5.5 Modify a video encoder configuration ....................................................... 204
Get guaranteed number of video 11.5.6 encoder instances ................................ 205
11.6 Audio source ....................................................................................................... 206
11.6.1 General ................................................................................................... 206
11.6.2 Get audio sources ................................................................................... 206
11.7 Audio source configuration .................................................................................. 207
11.7.1 Get audio source configurations .............................................................. 207
11.7.2 Get audio source configuration ................................................................ 208
11.7.3 Get compatible audio source configurations ............................................. 209
11.7.4 Get audio source configuration options .................................................... 210
11.7.5 Modify an audio source configuration ....................................................... 211
11.8 Audio encoder configuration ................................................................................ 212
11.8.1 Get audio encoder configurations ............................................................ 213
11.8.2 Get audio encoder configuration .............................................................. 213
11.8.3 Get compatible audio encoder configurations .......................................... 214
11.8.4 Get audio encoder configuration options .................................................. 215
11.8.5 Modify audio encoder configurations ........................................................ 217
11.9 Video analytics configuration ............................................................................... 217
11.9.1 Get video analytics configurations ........................................................... 218
11.9.2 Get video analytics configuration ............................................................. 218
11.9.3 Get compatible video analytics configurations ......................................... 219
11.9.4 Modify a video analytics configuration ..................................................... 220
11.10 Metadata configuration ........................................................................................ 222
11.10.1 Get metadata configurations .................................................................... 222
11.10.2 Get metadata configuration ...................................................................... 223
11.10.3 Get compatible metadata configurations .................................................. 223
11.10.4 Get metadata configuration options ......................................................... 224
11.10.5 Modify a metadata configuration .............................................................. 225
11.11 Audio outputs ...................................................................................................... 226
11.11.1 General ................................................................................................... 226
11.11.2 Get audio outputs .................................................................................... 226
11.12 Audio output configuration ................................................................................... 227
11.12.1 Get audio output configurations ............................................................... 227
11.12.2 Get audio output configuration ................................................................. 228
11.12.3 Get compatible audio output configurations ............................................. 229
11.12.4 Get audio output configuration options..................................................... 229
11.12.5 Modify audio output configuration ............................................................ 231
11.13 Audio decoder configuration ................................................................................ 231
11.13.1 Get audio decoder configurations ............................................................ 232
11.13.2 Get audio decoder configuration .............................................................. 232
11.13.3 Get compatible audio decoder configurations .......................................... 233
11.13.4 Get audio decoder configuration options .................................................. 234
11.13.5 Modify audio decoder configuration ......................................................... 235
11.14 Audio channel modes .......................................................................................... 236
11.15 Stream URI ......................................................................................................... 237
11.15.1 General ................................................................................................... 237
11.15.2 Request stream URI ................................................................................ 237
11.16 Snapshot ............................................................................................................. 239
11.16.1 General ................................................................................................... 239
11.16.2 Request snapshot URI ............................................................................. 239
11.17 Multicast .............................................................................................................. 239
Start 11.17.1 multicast streaming ......................................................................... 240
11.17.2 Stop multicast streaming ......................................................................... 240
11.18 Synchronization points ........................................................................................ 241
11.18.1 General ................................................................................................... 241
11.18.2 Set synchronization point......................................................................... 241
11.19 Service specific fault codes ................................................................................. 242
12 Real time streaming ...................................................................................................... 243
12.1 Media stream protocol ......................................................................................... 244
12.1.1 Transport format ...................................................................................... 244
12.1.2 Media transport ....................................................................................... 244
12.1.3 Synchronization point .............................................................................. 249
12.1.4 JPEG over RTP ....................................................................................... 249
12.2 Media control protocol ......................................................................................... 252
12.2.1 Stream control ......................................................................................... 252
12.3 Back channel connection ..................................................................................... 257
12.3.1 RTSP Require – Tag ............................................................................... 257
12.3.2 Connection setup for a bi- directional connection ..................................... 258
12.3.3 Multicast streaming.................................................................................. 260
12.4 Error handling ..................................................................................................... 260
13 Receiver configuration .................................................................................................. 260
13.1 Persistence ......................................................................................................... 260
13.2 Receiver modes .................................................................................................. 260
13.3 Receiver commands ............................................................................................ 261
13.3.1 Get receivers ........................................................................................... 261
13.3.2 Get receiver ............................................................................................. 261
13.3.3 Create receiver ........................................................................................ 262
13.3.4 Delete receiver ........................................................................................ 262
13.3.5 Configure receiver ................................................................................... 263
13.3.6 SetReceiverMode .................................................................................... 263
13.3.7 GetReceiverState .................................................................................... 264
13.4 Events ................................................................................................................. 264
13.4.1 ChangeState ........................................................................................... 264
13.4.2 Connection Failed .................................................................................... 265
13.5 Service specific fault codes ................................................................................. 265
14 Display service ............................................................................................................. 265
14.1 Panes .................................................................................................................. 266
14.1.1 GetPaneConfigurations ............................................................................ 266
14.1.2 GetPaneConfiguration ............................................................................. 267
14.1.3 SetPaneConfigurations ............................................................................ 268
14.1.4 SetPaneConfiguration .............................................................................. 269
14.1.5 CreatePaneConfiguration ........................................................................ 270
14.1.6 DeletePaneConfiguration ......................................................................... 271
14.2 Layout ................................................................................................................. 272
14.2.1 GetLayout ................................................................................................ 272
14.2.2 SetLayout ................................................................................................ 273
14.3 Display options .................................................................................................... 274
14.3.1 General ................................................................................................... 274
14.3.2 LayoutOptions ......................................................................................... 274
14.3.3 Coding Capabilities.................................................................................. 274
14.3.4 GetDisplayOptions ................................................................................... 274
14.4 Events ................................................................................................................. 275
14.4.1 General ................................................................................................... 275
14.4.2 Decoding error event ............................................................................... 275
14.5 Service specific fault codes ................................................................................. 276
15 Event handling ............................................................................................................. 277
15.1 Basic notification interface................................................................................... 277
15.1.1 General ................................................................................................... 277
15.1.2 Requirements .......................................................................................... 278
15.2 Real-time Pull-Point Notification Interface ........................................................... 279
15.2.1 Create pull point subscription .................................................................. 280
15.2.2 Pull messages ......................................................................................... 280
15.3 Notification streaming interface ........................................................................... 281
15.4 Properties ........................................................................................................... 281
15.4.1 Property example .................................................................................... 282
15.5 Notification structure ........................................................................................... 282
15.5.1 Notification information ............................................................................ 283
15.5.2 Message format ....................................................................................... 284
15.5.3 Property example, continued ................................................................... 285
15.5.4 Message description language................................................................. 286
15.5.5 Message content filter ............................................................................. 287
15.6 Synchronization point .......................................................................................... 288
15.7 Topic structure .................................................................................................... 289
15.7.1 ONVIF topic namespace .......................................................................... 289
15.7.2 Topic type information ............................................................................. 290
15.7.3 Topic filter ............................................................................................... 290
15.8 Get event properties ............................................................................................ 292
15.9 SOAP fault messages .......................................................................................... 293
15.10 Notification example ............................................................................................ 293
15.10.1 GetEventPropertiesRequest .................................................................... 293
15.10.2 GetEventPropertiesResponse .................................................................. 293
15.10.3 CreatePullPointSubscription .................................................................... 294
15.10.4 CreatePullPointSubscriptionResponse ..................................................... 295
15.10.5 PullMessagesRequest ............................................................................. 295
15.10.6 PullMessagesResponse ........................................................................... 296
15.10.7 UnsubscribeRequest ............................................................................... 297
15.11 Service specific fault codes ................................................................................. 297
16 PTZ control................................................................................................................... 297
16.1 PTZ Model........................................................................................................... 298
16.2 PTZ Node ............................................................................................................ 299
16.2.1 GetNodes ................................................................................................ 300
16.2.2 GetNode .................................................................................................. 300
16.3 PTZ configuration ................................................................................................ 301
16.3.1 GetConfigurations .................................................................................... 302
16.3.2 GetConfiguration ..................................................................................... 303
16.3.3 GetConfigurationOptions ......................................................................... 303
16.3.4 SetConfiguration ...................................................................................... 304
16.4 Move operations .................................................................................................. 305
16.4.1 AbsoluteMove .......................................................................................... 306
16.4.2 RelativeMove ........................................................................................... 307
16.4.3 ContinuousMove ...................................................................................... 309
16.4.4 Stop ........................................................................................................ 312
16.4.5 GetStatus ................................................................................................ 312
16.5 Preset operations ................................................................................................ 313
16.5.1 SetPreset ................................................................................................ 313
16.5.2 GetPresets .............................................................................................. 315
16.5.3 GotoPreset .............................................................................................. 316
16.5.4 RemovePreset ......................................................................................... 317
16.6 Home position operations .................................................................................... 317
16.6.1 GotoHomePosition ................................................................................... 317
16.6.2 SetHomePosition ..................................................................................... 318
16.7 Auxiliary operations ............................................................................................. 319
16.7.1 General ................................................................................................... 319
16.7.2 SendAuxiliaryCommand ........................................................................... 319
16.8 Predefined PTZ spaces ....................................................................................... 320
16.8.1 Absolute position spaces ......................................................................... 320
16.8.2 Relative translation spaces ...................................................................... 321
16.8.3 Continuous velocity spaces ..................................................................... 323
16.8.4 Speed spaces .......................................................................................... 324
16.9 Service specific fault codes ................................................................................. 325
17 Video analytics ............................................................................................................. 327
17.1 Scene description interface ................................................................................. 327
17.1.1 Overview ................................................................................................. 327
17.1.2 Frame related content.............................................................................. 327
17.1.3 Scene elements ....................................................................................... 330
17.2 Rule interface ...................................................................................................... 334
17.2.1 Rule representation ................................................................................. 335
17.2.2 Rule description language ....................................................................... 335
17.2.3 Standard rules ......................................................................................... 336
17.2.4 Operations on rules ................................................................................. 338
17.3 Analytics modules interface ................................................................................. 342
17.3.1 Analytics module configuration ................................................................ 342
17.3.2 Analytics module description language .................................................... 343
17.3.3 Operations on analytics modules ............................................................. 343
17.4 Service-specific fault codes ................................................................................. 347
18 Analytics device ........................................................................................................... 349
18.1 Overview ............................................................................................................. 349
18.2 Analytics engine input ......................................................................................... 349
18.2.1 GetAnalyticsEngineInputs ........................................................................ 350
18.2.2 GetAnalyticsEngineInput.......................................................................... 350
18.2.3 SetAnalyticsEngineInput .......................................................................... 351
18.2.4 CreateAnalyticsEngineInputs ................................................................... 352
18.2.5 DeleteAnalyticsEngineInputs ................................................................... 353
18.3 Video analytics configuration ............................................................................... 354
18.3.1 GetVideoAnalyticsConfiguration .............................................................. 354
18.3.2 SetVideoAnalyticsConfiguration ............................................................... 355
18.4 Analytics engines ................................................................................................ 356
GetAnalyticsEngines 18.4.1 ................................................................................ 356
18.4.2 GetAnalyticsEngine ................................................................................. 357
18.5 Analytics engine control ...................................................................................... 358
18.5.1 GetAnalyticsEngineControls .................................................................... 358
18.5.2 GetAnalyticsEngineControl ...................................................................... 359
18.5.3 SetAnalyticsEngineControl ...................................................................... 359
18.5.4 CreateAnalyticsEngineControl ................................................................. 360
18.5.5 DeleteAnalyticsEngineControl .................................................................. 362
18.6 GetAnalyticsState ................................................................................................ 362
18.7 Output streaming configuration ............................................................................ 363
18.7.1 General ................................................................................................... 363
18.7.2 Request stream URI ................................................................................ 363
19 Recording control ......................................................................................................... 364
19.1 General ............................................................................................................... 364
19.2 General requirements .......................................................................................... 366
19.3 Data structures .................................................................................................... 366
19.3.1 RecordingConfiguration ........................................................................... 366
19.3.2 TrackConfiguration .................................................................................. 366
19.3.3 RecordingJobConfiguration...................................................................... 366
19.4 CreateRecording ................................................................................................. 368
19.5 DeleteRecording .................................................................................................. 369
19.6 GetRecordings .................................................................................................... 369
19.7 SetRecordingConfiguration .................................................................................. 371
19.8 GetRecordingConfiguration ................................................................................. 371
19.9 CreateTrack ........................................................................................................ 372
19.10 DeleteTrack ......................................................................................................... 374
19.11 GetTrackConfiguration ........................................................................................ 374
19.12 SetTrackConfiguration ......................................................................................... 375
19.13 CreateRecordingJob ............................................................................................ 376
19.14 DeleteRecordingJob ............................................................................................ 377
19.15 GetRecordingJobs ............................................................................................... 378
19.16 SetRecordingJobConfiguration ............................................................................ 378
19.17 GetRecordingJobConfiguration ............................................................................ 379
19.18 SetRecordingJobMode ........................................................................................ 380
19.19 GetRecordingJobState ........................................................................................ 381
19.20 Events ................................................................................................................. 382
19.20.1 Recording job state changes ................................................................... 382
19.20.2 Configuration changes ............................................................................. 383
19.20.3 Data deletion ........................................................................................... 383
19.20.4 Recording and track creation and deletion ............................................... 383
19.21 Examples ............................................................................................................ 384
19.21.1 Example 1: Setup recording of a single camera ....................................... 384
19.21.2 Example 2: Record multiple streams from one camera to a single
recording ................................................................................................. 385
20 Recording search ......................................................................................................... 386
20.1 General ............................................................................................................... 386
20.2 Concepts ............................................................................................................. 387
20.2.1 Search direction ...................................................................................... 387
20.2.2 Recording event ...................................................................................... 387
20.2.3 Search session ........................................................................................ 387
20.2.4 Search scope .......................................................................................... 388
20.2.5 Search filters ........................................................................................... 388
20.3 Data structures .................................................................................................... 388
20.3.1 RecordingInformation structure ................................................................ 388
20.3.2 RecordingSourceInformation structure ..................................................... 388
20.3.3 TrackInformation structure ....................................................................... 389
20.3.4 SearchState enumeration ........................................................................ 389
20.3.5 MediaAttributes structure ......................................................................... 389
20.3.6 FindEventResult structure ....................................................................... 389
20.3.7 FindPTZPositionResult structure ............................................................. 390
20.3.8 PTZPositionFilter structure ...................................................................... 390
20.3.9 MetadataFilter structure ........................................................................... 390
20.3.10 FindMetadataResult structure .................................................................. 390
20.4 GetRecordingSummary ....................................................................................... 390
20.5 GetRecordingInformation ..................................................................................... 391
20.6 GetMediaAttributes .............................................................................................. 391
20.7 FindRecordings ................................................................................................... 392
20.8 GetRecordingSearchResults ................................................................................ 393
20.9 FindEvents .......................................................................................................... 394
20.10 GetEventSearchResults ...................................................................................... 395
20.11 FindPTZPosition .................................................................................................. 396
20.12 GetPTZPositionSearchResults ............................................................................ 397
20.13 FindMetadata ...................................................................................................... 398
20.14 GetMetadataSearchResults ................................................................................. 399
20.15 GetSearchState ................................................................................................... 400
20.16 EndSearch .......................................................................................................... 401
20.17 Recording Event Descriptions .............................................................................. 402
20.18 XPath dialect ....................................................................................................... 404
21 Replay control .............................................................................................................. 405
21.1 Use of RTSP ....................................................................................................... 405
21.2 RTP header extension ......................................................................................... 406
21.2.1 NTP timestamps ...................................................................................... 406
21.2.2 Compatibility with the JPEG header extension ......................................... 407
21.3 RTSP feature tag ................................................................................................. 407
21.4 Initiating Playback ............................................................................................... 407
21.4.1 Range header field .................................................................................. 408
21.4.2 Rate-Control header field ......................................................................... 408
21.4.3 Frames header field ................................................................................. 409
21.4.4 Synchronization points ............................................................................ 409
21.5 Reverse replay .................................................................................................... 410
21.5.1 Packet transmission order ....................................................................... 410
21.5.2 RTP sequence numbers .......................................................................... 410
21.5.3 RTP timestamps ...................................................................................... 410
21.6 RTSP keepalive ................................................................................................... 411
21.7 Currently recording footage ................................................................................. 411
21.8 End of footage ..................................................................................................... 411
21.9 Go to time ........................................................................................................... 411
21.10 Use of RTCP ....................................................................................................... 411
21.11 Replay service commands ................................................................................... 412
Request 21.11.1 replay URI ................................................................................. 412
21.11.2 ReplayConfiguration .............................