ONVIF Client protocol Profile S (Live Streaming) Dart implementation

This is a wrapper to ONVIF protocol which allows you to get information about your NVT (network video transmitter) device, its media sources, control PTZ (pan-tilt-zoom) movements and manage presets. It will also allow you to get information about your NVR (network video recorder).

pub package Build Status

Table of contents

Buy me a coffee

New for version 2.0.0

Device discovery is finally here. If you're using that cli utilities that became available from v1.0.0, you can discover Onvif devices on your network with the command:

onvif probe

Or, in dart code:

final multicastProbe = MulticastProbe();

await multicastProbe.probe();

for (var device in multicastProbe.onvifDevices) {
  print(
      '${device.name} ${device.location} ${device.hardware} ${device.xaddr}');
}

Getting Started

To use this package in your code, first add the dependency to your project:

dependencies:
  ...
  easy_onvif: ^2.0.13+4

If you need additional help getting started with dart, check out these guides.

Usage Example

Import the easy_onvif library.

import 'package:easy_onvif/onvif.dart';

Connecting to an Onvif device

final onvif = await Onvif.connect(
 host: [hostname or ip address],
 username: [username],
 password: [password]);

Interacting with the device through Onvif operations

Refer to the tables below for the supported operations.

Through the deviceManagement operations you can get information about the connected device.

var deviceInfo = await onvif.deviceManagement.getDeviceInformation();

print(deviceInfo.model);

Many operations require you to supply a profileToken which can be retrieved through media operations.

var profiles = await onvif.media.getProfiles();

profiles.forEach((element) {
 print('${element.name}  ${element.token}');
});

var profileToken = profiles[0].token;

With the ptz operations you can get a list of camera presets from the connected device.

var presets = await onvif.ptz.getPresets(profileToken);

//get a specific preset
var preset = presets[11];

//print the preset values
print(
 'preset: ${preset.position.panTilt?.x}  ${preset.position.panTilt?.y}  ${preset.position.zoom?.x}');

//use the GotoPreset operation to point the camera to the given preset
await onvif.ptz.gotoPreset(profileToken, preset);

Be sure to look through the API Reference for information about the parameters required for the supported Onvif operations.

Onvif cli (Onvif at the command prompt)

A command line interface for controlling an Onvif device with cli commands

Install using dart pub:

dart pub global activate easy_onvif

Install using brew:

brew tap faithoflifedev/easy_onvif
brew install onvif

Run the following command to see help:

onvif --help

Result,

A command line interface for controlling Onvif compliant devices

Usage: onvif <command> [arguments]

Global options:
-h, --help           Print this usage information.
    --config-file    (defaults to "$HOME/.onvif/credentials.json")
    --log-level      [all, debug, info, warning, error, off (default)]

Available commands:
  authorize           Generate an authentication file for an Onvif device
  device-management   Device management commands.
  media               Media commands.
  probe               Probe/device discovery command.
  ptz                 PTZ commands.

Please see the cli documentation README.md for more detailed usage information.

Supported Onvif Operations

Device Management

Onvif OperationDart MethodDart Return TypeTest
CreateUserscreateUsersFuture<void>[ ]
DeleteUsersdeleteUsersFuture<void>[ ]
GetCapabilitiesgetCapabilitiesFuture<Capabilities>[x]
GetDeviceInformationgetDeviceInformationFuture<GetDeviceInformationResponse>[x]
GetHostnamegetHostnameFuture<HostnameInformation>[x]
GetNetworkProtocolsgetNetworkProtocolsFuture<List<NetworkProtocol>>[x]
GetNTPgetNtpFuture<NtpInformation>[x]
GetServiceCapabilitiesgetServiceCapabilitiesFuture<DeviceServiceCapabilities>[x]
GetServicesgetServicesFuture<List<Service>>[x]
GetSystemDateAndTimegetSystemDateAndTimeFuture<SystemDateAndTime>[x]
GetSystemUrisgetSystemUrisFuture<GetSystemUrisResponse>[x]
GetUsersgetUsersFuture<List<User>>[x]

Media

Onvif OperationDart MethodDart Return TypeTest
GetAudioSourcesgetAudioSourcesFuture<AudioSource>[x]
GetProfilesgetProfilesFuture<List<Profile>>[x]
GetSnapshotUrigetSnapshotUriFuture<MediaUri>[x]
GetStreamUrigetStreamUriFuture<MediaUri>[x]
GetVideoSourcesgetVideoSourcesFuture<VideoSources>[x]
StartMulticastStreamingstartMulticastStreamingFuture<void>[ ]
StopMulticastStreamingstopMulticastStreamingFuture<void>[ ]

PTZ

Onvif OperationDart MethodDart Return TypeTest
AbsoluteMoveabsoluteMoveFuture<bool>[ ]
ContinuousMovecontinuousMoveFuture<bool>[x]
GetCompatibleConfigurationsgetCompatibleConfigurationsFuture<List<PtzConfiguration>>[x]
GetConfigurationgetConfigurationFuture<PtzConfiguration>[x]
GetConfigurationsgetConfigurationsFuture<List<PtzConfiguration>>[x]
GetPresetsgetPresetsFuture<List<Preset>>[x]
GetStatusgetStatusFuture<PtzStatus>[x]
GotoPresetgotoPresetFuture<bool>[ ]
RelativeMoverelativeMoveFuture<void>[ ]
RemovePresetremovePresetFuture<void>[ ]
SetPresetsetPresetFuture<String>[x]
StopstopFuture<bool>[x]

PTZ Helper Methods

Onvif OperationDart MethodReturn Type
N/AmoveFuture<void>
N/AmoveDownFuture<void>
N/AmoveLeftFuture<void>
N/AmoveRightFuture<void>
N/AmoveUpFuture<void>
N/AzoomInFuture<void>
N/AzoomOutFuture<void>
N/AgetCurrentPresetFuture<Preset?>

Tested Onvif Devices

The values returned by the Onvif API GetDeviceInformation call.

ManufacturerModelKnown Issue
D-Link CorporationDCS-6511
HappytimesoftIPCamera
ONVIFENP1A14-IR/25X
TP-LinkTL-IPC43AN-4RelativeMove¹
UnknownGX728MF-IR28

¹ For TP-Link, RelativeMove is not properly supported on the tested device, however easy_onvif falls back to GetStatus and AbsoluteMove to simulate a relative move.

What's next

  • More comprehensive unit tests

Libraries

easy_onvif
ONVIF Client Implementation in Dart
onvif_authorize_command
onvif_device_management_command
onvif_helper_command
onvif_media_command
onvif_probe_command
onvif_ptz_command
onvif_version_command