onvif protocol

Simple management of onvif IP-devices cameras. onvif is an implementation of ONVIF protocol for managing onvif IP devices. The purpose of this library is convenient and easy management of IP cameras and other devices that support ONVIF standard.

Note: This repository is a fork and modification of use-go/onvif. We have made custom changes based on the original work. Special thanks to the original authors and contributors of the use-go/onvif project.

Changes and Modifications

This fork includes the following modifications compared to the original use-go/onvif repository:

1. Updated to Go 1.25: The project has been upgraded to use Go 1.25, taking advantage of the latest language features and improvements.

2. Updated Dependencies: All related dependency libraries have been updated to their latest compatible versions for better security, performance, and bug fixes.

3. Migrated to Standard Library Logging: All logging has been migrated to use Go's standard library slog package instead of third-party logging libraries, reducing external dependencies and improving consistency.

4. Fixed Issues from Original Repository: Various issues from the original repository have been addressed. For specific fixes and details, please refer to the commit history.

Installation

To install the library, use go get:

go get github.com/gowvp/onvif

Supported services

The following services are implemented:

• Device
• Media
• PTZ
• Imaging
• Event
• Discovery
• Auth(More Options)
• Soap

Using

General concept

1. Connecting to the device
2. Authentication (if necessary)
3. Defining Data Types
4. Carrying out the required method

Connecting to the device

If there is a device on the network at the address 192.168.13.42, and its ONVIF services use the 1234 port, then you can connect to the device in the following way:

dev, err := onvif.NewDevice(onvif.DeviceParams{Xaddr: "192.168.13.42:1234"})

The ONVIF port may differ depending on the device , to find out which port to use, you can go to the web interface of the device. Usually this is 80 port.

Authentication

If any function of the ONVIF services requires authentication, you must use the Authenticate method.

device := onvif.NewDevice(onvif.DeviceParams{Xaddr: "192.168.13.42:1234", Username: "username", Password: password})

Defining Data Types

Each ONVIF service in this library has its own package, in which all data types of this service are defined, and the package name is identical to the service name and begins with a capital letter. onvif defines the structures for each function of each ONVIF service supported by this library. Define the data type of the GetCapabilities function of the Device service. This is done as follows:

capabilities := device.GetCapabilities{Category:"All"}

Why does the GetCapabilities structure have the Category field and why is the value of this field All?

The figure below shows the documentation for the GetCapabilities. It can be seen that the function takes one Category parameter and its value should be one of the following: 'All', 'Analytics',' Device ',' Events', 'Imaging', 'Media' or 'PTZ'`.

An example of defining the data type of GetServiceCapabilities function in PTZ:

ptzCapabilities := ptz.GetServiceCapabilities{}

The figure below shows that GetServiceCapabilities does not accept any arguments.

Common data types are in the xsd/onvif package. The types of data (structures) that can be shared by all services are defined in the onvif package.

An example of how to define the data type of the CreateUsers function in Devicemgmt:

createUsers := device.CreateUsers{User: onvif.User{Username:"admin", Password:"qwerty", UserLevel:"User"}}

The figure below shows that ,in this example, the CreateUsers structure field must be a User whose data type is the User structure containing the Username, Password, UserLevel, and optional Extension fields. The User structure is in the onvif package.

Carrying out the required method

To perform any function of one of the ONVIF services whose structure has been defined, you must use the CallMethod of the device object.

createUsers := device.CreateUsers{User: onvif.User{Username:"admin", Password:"qwerty", UserLevel:"User"}}
device := onvif.NewDevice(onvif.DeviceParams{Xaddr: "192.168.13.42:1234", Username: "username", Password: password})
device.Authenticate("username", "password")
resp, err := dev.CallMethod(createUsers)

Great Thanks

This project is based on and modified from: use-go/onvif

We would like to express our sincere gratitude to the original authors and all contributors of the use-go/onvif project for their excellent work.

The original use-go/onvif project was enhanced and improved from: goonvif