5.2.2. Release notes for v0.10

About release 0.10

The main feature of this SDK release is support for Proximie services REST APIs to programmatically manage media server sessions.

Additionally, there are some improvements and bug fixes, please see the release notes for details.

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

Deprecated APIs

In places, this release uses the C++ [[deprecated]] attribute to mark some APIs as deprecated. Deprecations may be errors for your application, depending on your compiler settings. For more details see C++ attribute: deprecated.

v0.10.0

Feature: Additional Proximie REST API support

This release adds further support for calling Proximie REST APIs from the SDK using the ProximieServices class:

createSession() (link: Create session)
deleteSession() (link: Delete session)
getOrganisations() (link: Get my organisations)
getOrganisationMembers() (link: Get Members by Organisation ID)
getFacilities() (link: Get facilities)
getFacilityRooms() (link: Get rooms)
getNonRoomNotations() (link: Get available notations for non-rooms)
getSpecialities() (link: Get Session Specialities taxonomy)
getSurgicalTypes() (link: Get Surgical Types taxonomy)
getSessionAccesses() (link: Get Session Accesses taxonomy)
getThisUser() (link: Get my user information)

Note that creating a session requires various details, such as the organisation, facility, room, etc. The demo has been updated to show how these details can be obtained using the above functions.

Obtaining feeds from sessions

Both MediaServerSession and PeerSession now support functions to list and get feeds from that session.

For consistency these functions are named the same for both types of session:

MediaServerSession::listSessionFeeds PeerSession::listSessionFeeds - list session’s feeds as objects
MediaServerSession::listSessionFeedIds PeerSession::listSessionFeedIds - list the session feeds stream IDs
MediaServerSession::getFeed PeerSession::getFeed - obtain a feed given it’s stream ID

Note that we have deprecated PeerSession::listFeeds in favour of listSessionFeedIds() for clarity and consistency.

Feed object casting and type checking

Feed objects now support is() and as() methods to easily check and cast feed objects types.

// Where 'feed' is a std::shared_ptr<PxMedia::FeedBase>:

// Check if the feed type is a given derived type
bool isOutgoing = feed->is<PxMedia::MediaServerOutgoingVideoFeed>();

// Downcast the feed to a derived shared_ptr type
// NB returns nullptr if the feed is not derived from that type
auto outgoing = feed->as<PxMedia::MediaServerOutgoingVideoFeed>();