You must migrate to the 2022/06 bsn.cloud APIs if you want to use any of the Series 5 players (except the AU335, which is supported in bsn.cloud 2020/10 APIs). In previous versions, these players will show up as "unknown" and new video walls, 8K images and other Series 5 related features are not supported. See https://www.brightsign.biz/brightsign-players/series-5/ for more information about Series 5 players.
Series 5 Changes
The 2022/06 API supports BrightSign Series 5 players with the following changes:
The Player Models Enumeration (2022/06) has been extended by the "XC2055", "XC4055", "LS425", "LS445", "HS125", "HS145", "HD225", "HD1025", "XD235", "XD1035", "XT245", "XT1145", and "XT2145" elements.
TheVideoMode Enumeration (2022/06)(DOCS-1182) has been extended by the "7680x4320x60p", "7680x4320x59.94p", "7680x4320x50p", "7680x4320x30p", "7680x4320x29.97p", "7680x4320x25p", "7680x4320x24p", "7680x4320x23.976p", "3072x2048x30p", "1536x2048x30p" elements.
The Regular Groups Entity (2022/06) has been extended by the [string] XCX55Firmware and [string] XTX45_XDX35_HDX25_LS4X5_HS1X5Firmware properties.
Business Operations Appliance Changes
In previous API versions, the business operations listed also included non-applicable operations. We addressed this usability bug by providing new information in the OperationAppliance property as shown below:
The Business Operations Entity (2022/06) was extended by the [OperationAppliance] Appliance property and the OperationAppliance enumeration was defined. It may have one or more unique {"Instance", "Collection", "Unknown"} values:
The "Instance" value indicates that the given business operation applies to specific entity instances.
The "Collection" value indicates that the given business operation applies to collections of entities in a network and associated folders.
The "Unknown" value indicates that it is unknown whether the business operation will apply to specific entity instances or a collection of entities.
Please update your client and display as follows:
Where you define instance-specific permissions, display only BusinessOperations which have "Instance" values. In BrightAuthor:connected, this would be in entity properties panels such as Content, where you can define object permissions for specific instances.
Where you define permissions or collections of entities, display only the BusinessOperations which have "Collection" values. In BrightAuthor:connected, this would be in Admin > Roles & Permissions, where you create custom roles and define player permissions.
Otherwise, use the "Unknown" value.
HTTP Conditional Request Support
Most of our entities already support conditional requests according to rfc7232, but conditional request were missing for the following three entities and have now been implemented:
New information has been provided for some entities (LastModifiedDate and AutomaticSubscriptionsManagementEnabled). These are optional and can be implemented if you wish or otherwise ignored. Other minor fixes have also been implemented:
The [DateTime] LastModifiedDate property is no longer nullable.
The GET ~/2022/06/REST/Self/Networks/{networkId}/Subscription/ and GET ~/2022/06/REST/Self/Networks/{networkId}/Subscription/methods set the Last-Modified HTTP response header to the [DateTime] LastModifiedDate property value of the returned entity.
The PUT ~/2022/06/REST/Self/Networks/{networkId}/Subscription/ and PUT ~/2022/06/REST/Self/Networks/{networkId}/Subscription/methods accept the optional If-Unmodified-Since HTTP Request Header and evaluate condition against the target entity.