Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: updated format

All device entities are structured as follows:

entity:

[

Id int

] Id

 A unique identifier for the device instance

[

Serial string

] Serial

:

  The

The device serial number 

[

Name string

] Name

: The device name

[

ConcatUnitNameAndSerialbool

]  ConcatUnitNameAndSerial

:  The device-naming method: True indicates that clients should append the device serial number to the device name, False indicates that nothing should be appended to the device name.

[

Description string

] Description

: A customer-defined description of the device. The description does not need to be unique within the scope of the account.

[

CurrentSubscription DeviceSubscription

] CurrentSubscription

: See Device Subscription Entity

[GroupInfo]

 TargetGroup GroupInfo

[

Id int

] Id

: The unique identifier for the group instance to which the device belongs.

[

Name string

] Name

: The name of the group instance to which the device belongs

[

TaggedGroups TaggedGroupInfo[]

] TaggedGroups

:

[

Id int

] Id

: The unique identifier for the tagged group

[

Name string

] Name

: The name of the tagged group

[

TargetBrightWall BrightWallInfo

] TargetBrightWall

: 

[

Id int?

] Id

A unique identifier for the BrightWall

[

Name string

] Name

: The BrightWall name

[

TargetBrightWallScreenNumber Nullable<byte>

] TargetBrightWallScreenNumber

: 

[

ReportedGroup GroupInfo

] ReportedGroup

:

[

Id int

] Id

: .The unique identifier for the reported group

[

Name string

] Name

The name of the reported group

[

ReportedBrightWall BrightWallInfo

] ReportedBrightWall

: 

[

Id int

] Id

The identifier and primary key of the BrightWall instance.

[

Name string

] Name

The user-defined name of the BrightWall instance. This alternate key must be unique in the scope of the BSN account.

[

ReportedBrightWallScreenNumber Nullable<byte>

] ReportedBrightWallScreenNumber

The BrightWall screen number that the device reported belonging to when it last synchronized with the server. This value is set to Null when the device is assigned to a group instance.

[

Presentation PresentationInfo

] Presentation

: See the Presentation Info Entity

[

Model DeviceModel

] Model

The device model name and suffix

[

Family DeviceFamily

] Family

The model family of the device ("Sebring", "Pagani", etc.)

[

LastModifiedDate DateTime

] LastModifiedDate

A UTC timestamp indicating when the player instance was last modified. See DateTime for more information about this data type.

[

Autorun DeviceAutorun

] Autorun

:

[

Version string

] Version

The current presentation autorun version assigned to the group

[

IsCustom bool

] IsCustom

: Whether the autorun is a standard BrightAuthor file (false) or a custom-built file (true)

[

MinFirmwares DeviceFirmware[]

] MinFirmwares

An array of firmware instances indicating the minimum firmware version required to run the autorun on a player. Since different model families can have different minimum firmware requirements, this array can contain more than one firmware instance.

[

version string

] version

: The firmware version number

[string

supportedModels  string [ ]

] supportedModels

: An array of string values indicating which model numbers (e.g. "XDx233") apply for the minimum-firmware requirement

[

IsRevoked bool

] IsRevoked

: Whether or not the current presentation autorun version is supported/in service

[

FirmwareVersion string

] FirmwareVersion

The version of firmware that the device was using the last time it synced with the server.

[

CardSize string

] CardSize

The total size of the device storage. This information is displayed in the format “{0} MiB” or “{0:F2} GiB” (where F2 is equivalent to a fixed-point number with two decimal digits (e.g. “1.75 GiB”)).

[

CardFreeSize string

] CardFreeSize

The amount of free space on the device storage. This information is displayed in the format “{0} MiB” or “{0:F2} GiB” (where F2 is equivalent to a fixed-point number with two decimal digits (e.g. “1.75 GiB”)).

[

TargetTimeZone string

] TargetTimeZone

The string name of the time zone that the device should use

[

ReportedTimeZone string

] ReportedTimeZone

The string name of the time zone that the device reported using the last time it synced with the server.

[

ScreenColor string

] ScreenColor

The background color of the screen 

[

ContentCheckPeriod DeviceConnectionsPeriod

] ContentCheckPeriod

Represents the time interval between synchronization events, when the device checks with the BrightSign Network servers for content updates.

[

ContentDownloadsStartTime Nullable<TimeSpan>

] ContentDownloadsStartTime

The time each day (according to the reported time zone) when the device should begin downloading content from the BrightSign Network persistent storage. A Null value indicates that the device can download content at any time during the day. 

[

ContentDownloadsEndTime Nullable<TimeSpan>

] ContentDownloadsEndTime

The time each day (according to the reported time zone) when the device should finish downloading content from the BrightSign Network persistent storage. A Null value indicates that the device can download content at any time during the day. See TimeSpan for more information about this data type.

[

HealthReportingPeriod DeviceConnectionsPeriod

] HealthReportingPeriod

A DeviceConnectionsPeriod enumeration representing the interval between health-report events, when the device checks in with the server to report its status.

[

HealthReportingStartTime Nullable<TimeSpan>

] HealthReportingStartTime

The time each day (according to the reported time zone) when the device should begin sending health status updates to the BrightSign Network servers. A Null value indicates that the device can send reports at any time during the day. See TimeSpan for more information about this data type.

[

HealthReportingEndTime Nullable<TimeSpan>

] HealthReportingEndTime

The time each day (according to the reported time zone) when the device should stop sending health status updates to the BrightSign network servers. A Null value indicates that the device can send reports at any time during the day. See TimeSpan for more information about this data type.

[

LastContentCheckTime DateTime

] LastContentCheckTime

A timestamp indicating when the device last checked in with the BrightSign Network servers for content updates. See DateTime for more information about this data type.

[

LastSyncSpecProcessedTime DateTime

] LastSyncSpecProcessedTime

A timestamp indicating when the player finished processing the last retrieved sync spec. See DateTime for more information about this data type.

[

LastContentDownloadStartTime DateTime

] LastContentDownloadStartTime

A timestamp indicating when the device last began downloading content from the BrightSign Network servers. See DateTime for more information about this data type.

[

LastContentDownloadEndTime DateTime

] LastContentDownloadEndTime

A timestamp indicating when the device last completed downloading content from the BrightSign Network servers. See DateTime for more information about this data type.

[

LastHeartbeatTime DateTime

] LastHeartbeatTime

A timestamp indicating when the device last reported its health status to the BrightSign Network servers. See DateTime for more information about this data type.

[

LastErrorTime DateTime

] LastErrorTime

A timestamp indicating the most recent time that the device reported a current error. See DateTime for more information about this data type.

[

Uptime TimeSpan

] Uptime

The length of time that the player has been running. See TimeSpan for more information about this data type.

[

HealthStatus DeviceHealthStatus

] HealthStatus

Returns either "Normal", "Warning", "Error", or "Unknown"

[

NetworkSettings DeviceNetworkSettings

] NetworkSettings

: See Device Network Settings Entity

[

RemoteSnapshotSettings

]

RemoteSnapshotSettings:

[

Enabledbool

] Enabled

A flag specifying whether the remote snapshot feature is enabled or disabled on the device.

[

CaptureInterval TimeSpan

] CaptureInterval

The amount of time to elapse between each screenshot. This value can be between 00:01:00 and 24:00:00.

[

ScreenShotsCountLimit ushort

] ScreenShotsCountLimit

The maximum number of remote snapshot images allowed on player storage. Once this number is reached, the player will begin deleting Remote Snapshot images, beginning with the oldest first. This value can range from 1 to 100.

[

ImageQuality byte

] ImageQuality

The quality of remote snapshot images on the player. This value can range from 1 to 100.

[

ScreenOrientation

]

ScreenOrientationA ScreenOrientation enumeration indicating whether the remote snapshot images are landscape or portrait oriented. There are two portrait modes, so the return values would be either landscape, portrait bottom left, or portrait bottom right.

[

LogsSettings DeviceLogsSettings

] LogsSettings

: See Device Logs Settings Entity

[

DiagnosticWebServerSettings

]

DiagnosticWebServerSettings: See DiagnosticWebServer Settings Entity

[

LocalWebServerSettings

]

LocalWebServerSettings: See LocalWebServer Settings Entity

[

DeviceLocation

]

DeviceLocation: See Device Location Entity

[

Beacons DeviceBeacon[

]

]

Beacons

: See Device Beacon Entity

[

Tags Dictionary<string, string>

] Tags

An object where the tag keys are object properties and the tag values are the values of these properties. See the example below but note that the value is not necessarily "Country", "City", and "Number", but can be any object property value:

string::[Device].<Country>: "Ukraine"

string::[Device].<City>: "Odesa"

number::[Device].<Number>: "1"

[

Permissions List<Permission>

] Permissions

The device permissions entity. See the Permission Entity