5.1.1. Release notes for v0.14

About release 0.14

The main features of this SDK release include:

  • Several improvements to video stages when using them in different combinations and orders. Previously certain orders and combinations could cause visual artefacts or conflicts.

  • Text overlay now supports the ability to set the text while the feed is playing.

  • Fixes to some previously noted issues with the privacy mode.

  • Some previously deprecated features have now been removed (see below for details).

  • Improvements to the demo application to demonstrate the new features and options available.

NOTE: This release introduces some breaking changes, please see the notes below.

v0.14.0

Previously deprecated features removed

The following classes and features, which were previously deprecated, have been removed:

  • PxMedia::VideoStageRotateCrop

  • PxUtility::HttpFetchTyped

  • PxUtility::RestService

Fixes to previous known issues with VideoStagePrivacy

Now when using VideoStagePrivacy:

  • When the privacy state is toggled, the video feed resolution matches the incoming feed resolution (previously it was set to a fixed output resolution).

  • When using the privacy feature with AVOutputFeedFile, the output file will be continuous (previously, it would split the file when privacy was toggled).

  • Visual artefacts and conflicts between privacy and other video stages such as rotate and crop, or adaptive streaming, have now been resolved.

New feature: Feed request support for setting text overlay text

The feed request now supports setting text overlay text while the feed is playing, using a new request type: VideoStageTextOverlay::RequestSetText.

For more information on feed requests, see the Feed Requests section.

Updated demo features & fixes

Previously the demo applied the same adaptive streaming size, irrespective of whether the feed was cropped or rotated. This resulted in the video appearing with an incorrect aspect ratio, causing the video to be stretched or squashed. Now, the demo accounts for these stages when they are applied so the correct adaptive streaming size is used.

The demo application can now demonstrate additional “feed stages”, including specifying the order that stages are applied:

  • --demo-crop=<n>: Crop the outgoing session video by the specified number of pixels from each side.

  • --demo-rotate=ON: Demonstrates rotating the outgoing session feed by 90 degrees clockwise.

  • --demo-privacy=ON: Toggles privacy on the webcam feed at intervals.

  • --demo-text-overlay=<text>: Sets the text overlay on the webcam to the specified text.

  • --demo-framerate=<fps>: Sets a frame rate to apply to the outgoing session feed.

The order in which the options appear on the command line determines the order in which they are applied to the outgoing session video feed (not the demo “preview” shown at demo startup).

You can also now choose whether the demo outputs the local webcam feed to a window or to a UDP output. Use the --video-output=<out> with a value of window or udp to specify the output type. The output defaults to window if not specified.