Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
All player

All player synchronization settings entities are structured as follows:

Description string

entity:

  • Name string: The device name. The maximum length of this string is 128 characters.

  • :

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

    • ConcatNameAndSerial bool:  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.

    • SetupType DeviceSetupTypeEither "Standalone", "BSN", "LFN", "SFN",  "PartnerApplication", or "Unknown"

    • Group GroupInfo

      • Id int: The unique identifier for the group instance to which the device belongs.
      • Name string: The name of the group instance to which the device belongs
    • BrightWall BrightWallScreenInfo: 

      • Id Nullable<int>A unique identifier for the BrightWall

      • Name string: The BrightWall name

      • Screen byteThe BrightWall screen number to which the device is assigned

      • Link UriThe Uri of the BSN.cloud API for the BrightWall

    • Timezone stringThe time zone of the player

    • Screen DeviceScreenSettings

      • IdleColor stringThe AARRGGBB color code for the idle screen
      • SplashUrl UriThe Uri address for the splash screen
    • Synchronization PlayerSynchronizationSettingsSupported representations include:

      Status PlayerStatusSynchronizationSettings

      • Period TimeSpanThe frequency of the status updates that the player sends to the server. Currently, the value is five minutes for all players.
    • Settings PlayerSettingsSynchronizationSettings

      • Period TimeSpan: The frequency of the synchronization settings updates that the player sends to and receives from the server, to ensure that it hasn’t missed an update from the server

    • Schedule PlayerScheduleSynchronizationSettings:

      • Period TimeSpan: Players with "BSN" setup type only use this to check for missed updates of scheduled content

    • Content PlayerContentSynchronizationSettings:

      • Start TimeSpan:  Defines the time of the day when the player is allowed to download content (to avoid network impacts). See TimeSpan for more information about this data type.
      • End TimeSpan:  Defines time of the day when the player is allowed to download content (to avoid network impacts). See TimeSpan for more information about this data type.
    • Network PlayerNetworkSettings: The Player Network Settings Entity

    • Beacons DeviceBeacon[]: An array of Device Beacons entities

    • Location DeviceLocationSupported representations include:

      • PlaceId stringThe textual identifier of the device location

      • GPSLatitude Nullable<double>: The latitude of the device location

      • GPSLongitude Nullable<double>: The longitude of the device location

      • Country stringThe country in which the device is located (for example, "Germany")

      • CountryLongName stringThe full name of the country in which the device is located (for example, "Federal Republic of Germany")

      • AdminAreaLevel1 stringThe largest subnational administrative unit of a country (for example, "state" in the USA and "prefecture" in Japan) in which the device is located
      • AdminAreaLevel1LongName stringThe full name of the largest subnational administrative unit of a country in which the device is located
      • AdminAreaLevel2 stringThe county name (within the United States), or a second-order civil entity below adminAreaLevel1, in which the device is located. 

      • AdminAreaLevel2LongName stringThe full county name (within the United States), or the full name of the second-order civil entity below adminAreaLevel1, in which the device is located.

      • Locality stringThe name of the city, town, or rural area in which the device is located

      • LocalityLongName stringThe full name of the city, town, or rural area in which the device is located

      • Path stringThe path property of the location structure. This value is the result of the concatenation of Country, AdminAreaLevel1, AdminAreaLevel2, and Locality.

      • PathLongName stringThe path property of the location structure. This value is the result of the concatenation of CountryLongName, AdminAreaLevel1LongName, AdminAreaLevel2LongName, and LocalityLongName.

    • Screenshots PlayerScreenshotsSettings: 

      • Interval TimeSpan: How often the player should take a snapshot of the presentation display. See TimeSpan for more information about this data type.
      • CountLimit ushortHow many images can be stored on the local storage of the player (the maximum is 100 images)
      • Quality byteThe quality level of each image file

      • Orientation ScreenOrientation: One of "Unknown", "Landscape", "PortraitBottomLeft", or "PortraitBottomRight"

      Logging DeviceLogsSettings

      LastModifiedDate DateTime: The date on which the settings were last modified. See DateTime
      • EnableDiagnosticLog bool: Whether or not diagnostic logging is enabled on the associated device

      • EnableEventLog boolWhether or not event logging is enabled on the associated device

      • EnablePlaybackLog boolWhether or not playback logging is enabled on the associated device

      • EnableStateLog boolWhether or not state logging is enabled on the associated device

      • EnableVariableLog boolWhether or not variable logging is enabled on the associated device

      • UploadAtBoot bool:  Whether logs will be uploaded when the device boots

      • UploadTime Nullable<TimeSpan>The time when the device will upload logs to BSN.cloud, if available. See TimeSpan for more information about this data type.
    • LWS LocalWebServerSettings

      • Username string: The local web server username (for example, "admin")
      • Password string:  The local web server password
      • EnableUpdateNotifications bool: Whether or not enable update notifications is enabled
    • LDWS DiagnosticWebServerSettings

      • Password string: The password associated with the local diagnostic web server
      •  for more information about this data type.