Introduction
Introduction to MIP SDK 2021 R2
MIPSDK General
- Two new messages,
Server.AlarmNotificationsDisabledIndication
and Server.AlarmNotificationsEnabledIndication
, have been added, indicating when alarm notifications are disabled and enabled from Smart Client. Be aware that alarms can also be disabled for other reasons, such as the alarm definition being disabled, time profiles, etc, and these messages will not fire in those cases.
Smart Client
-
ImageViewerAddOn has been extended with a new method and two properties to control digital zoom:
- DigitalZoomEnable, a property to enable or disable digital zoom.
- DigitalZoomRectangle, a property to get and set the rectangle which is zoomed into.
- DigitalZoomMove, a method which is used to move the zoom rectangle.
Configuration API
- The Configuration API has been extended with support for managing the recording server failover groups. This includes creating, deleting groups, and assigning failover servers into groups. A 'move' method is used to assign a failover server to a specific position in the ordered list.
- The Configuration API has been extended to support management of PTZ COM ports on video servers, or cameras with a COM port. For hardware that has a COM port to control PTZ, it is possible to define what camera it relates to, and the COM port and protocol to use. The configuration is similar to the Management Client's Hardware PTZ tab.
- PTZ session timeout fields are made available through the Configuration API.
-
Support for getting presets from hardware device has been added. The function works in two steps:
- Get a list of the presets from the device.
- Apply the above presets to the configuration.
All old presets are removed and that is the same way it works in the Management Client.
-
Added Configuration API support for configuring patrolling profiles for cameras. The profiles have similar configuration structure as seen in the Management Client, except for the test buttons. The profiles are located as a child to a camera item, when PTZ is supported by the camera. The relevant ItemTypes are:
- PatrollingProfileFolder: Contains all the profiles.
- PatrollingProfile: Contains one profile with a number of ChildItems for each preset position.
- PatrollingProfileEntry: Contains one preset entry, and is a ChildItem and included in the PatrollingProfile item during API operations.
Start/Stop/Pause/Resume rule actions have also been added.
- Multicast support on recording servers can now be configured using the Configuration API.
- Support for managing Smart Client profiles has been added. This includes the ability to read all profiles as well as creating and updating profile properties. Role configuration has been changed to allow selecting what client profile is active on a particular role.
NuGet
- A new NuGet package,
MilestoneSystems.VideoOS.Platform.SDK-CPP
, has been made available for integration with C++ applications.
- VPSCommon is now available on NuGet.org.
Video Processing Service (VPS)
- VPS samples are now available on GitHub.com and VPSCommon is now available on NuGet.org.
- The VPService project in the VPService solution has been updated to use .NET Core 3.1, and the C++ projects in the VPService solution have been updated to use Platform Toolset v142. All NuGet packages in the VPService project have been updated to their newest versions.
Samples
- The
CameraPlaybackControl
sample has been renamed to SCImageViewerAddOn
and contains functionality for both digital zoom and independent playback.
- The VPS Configuration plugin sample has been updated to select the Management Server URL from the Site addresses and allow creation of VPS hardware on stand-alone Recording Servers.
Fixed issues
- Calling a method on a ConfigurationItem where Children has not been populted, might in some cases throw ArgumentMIPException.
- Various
BookmarkService
methods would incorrectly throw null reference exception if null was passed as the kinds
parameter.