--- title: Player Settings Entity (2022/06) slug: develop/player-settings-entity-202206 docTags: createdAt: 2025-03-11T07:03:30.743Z --- All Player Settings entities are structured as follows: `entity`: - `Name` string read-write: The player name. The maximum length of this string is 128 characters. - `Description` string read-write: A customer-defined description of the player. The description does not need to be unique within the scope of the account. - `ConcatNameAndSerial` bool read-write: The player-naming method: `True` indicates that clients should append the device serial number to the player name, `False` indicates that nothing should be appended to the player name. - `SetupType` DeviceSetupType read-only: Either "Standalone", "BSN", "LFN", "SFN", "PartnerApplication", or "Unknown" - `Group` GroupInfo: - `Id` int read-write: The unique identifier for the group instance to which the device belongs. - `Name` string read-write: The name of the group instance to which the device belongs - `BrightWall` object read-write: This property is deprecated and will be removed in the next BSN.Cloud API version - `Timezone` string read-write: The time zone of the player - `Screen` DeviceScreenSettings: - `IdleColor` string read-write: The AARRGGBB color code for the idle screen - `SplashUrl` Uri read-write: The Uri address for the splash screen - `Synchronization` PlayerSynchronizationSettings read-write: The [Player Synchronization Settings Entity](docId:9wQlt7eW-kTnaOgp5WTjD) - `Network` PlayerNetworkSettings read-write: The [Player Network Settings Entity](docId\:jLx8nx2W5TzDZSRyVoqDq) - `Beacons` DeviceBeacon[] read-write: An array of [Player Beacon](docId\:BsgHv6pw46ZE0xu2T2I8I) entities - `Location` DeviceLocation: - `PlaceId` string read-write: The textual identifier of the player location - `GPSLatitude` Nullable<double> read-write: The latitude of the player location - `GPSLongitude` Nullable<double> read-write: The longitude of the player location - `Country` string read-write: The country in which the player is located (for example, "Germany") - `CountryLongName` string read-write: The full name of the country in which the player is located (for example, "Federal Republic of Germany") - `AdminAreaLevel1` string read-write: The largest subnational administrative unit of a country (for example, "state" in the USA and "prefecture" in Japan) in which the player is located - `AdminAreaLevel1LongName` string read-write: The full name of the largest subnational administrative unit of a country in which the player is located - `AdminAreaLevel2` string read-write: The county name (within the United States), or a second-order civil entity below adminAreaLevel1, in which the player is located. - `AdminAreaLevel2LongName` string read-write: The full county name (within the United States), or the full name of the second-order civil entity below adminAreaLevel1, in which the player is located. - `Locality` string read-write: The name of the city, town, or rural area in which the player is located - `LocalityLongName` string read-write: The full name of the city, town, or rural area in which the player is located - `Path` string read-only: The path property of the location structure. This value is the result of the concatenation of `Country`, `AdminAreaLevel1`, `AdminAreaLevel2`, and `Locality`. - `PathLongName` string read-only: The path property of the location structure. This value is the result of the concatenation of `CountryLongName`, `AdminAreaLevel1LongName`, `AdminAreaLevel2LongName`, and `LocalityLongName`. - `Screenshots` PlayerScreenshotsSettings: - `Interval` TimeSpan read-write: How often the player should take a snapshot of the presentation display. See [TimeSpan](docId\:dX1C8uSfkXPwntpRb9f-T) for more information about this data type. - `CountLimit` ushort read-write: How many images can be stored on the local storage of the player (the maximum is 100 images) - `Quality` byte read-write: The quality level of each image file - `Orientation` ScreenOrientation read-write: One of "Unknown", "Landscape", "PortraitBottomLeft", or "PortraitBottomRight" - `Logging` DeviceLogsSettings: - `EnableDiagnosticLog` bool read-write: Whether or not diagnostic logging is enabled on the associated player - `EnableEventLog` bool read-write: Whether or not event logging is enabled on the associated player - `EnablePlaybackLog` bool read-write: Whether or not playback logging is enabled on the associated player - `EnableStateLog` bool read-write: Whether or not state logging is enabled on the associated player - `EnableVariableLog` bool read-write: Whether or not variable logging is enabled on the associated player - `UploadAtBoot` bool read-write: Whether logs will be uploaded when the player boots - `UploadTime` Nullable<TimeSpan> read-write: The time when the player will upload logs to BSN.Cloud, if available. See [TimeSpan](docId\:dX1C8uSfkXPwntpRb9f-T) for more information about this data type. - `LWS` LocalWebServerSettings: - `Username` string read-write: The local web server username (for example, "admin") - `Password` string read-write: The local web server password - `EnableUpdateNotifications` bool read-write: Whether or not enable update notifications is enabled - `LDWS` DiagnosticWebServerSettings: - `Password` string read-write: The password associated with the local diagnostic web server - `LastModifiedDate` DateTime read-only: The date on which the settings were last modified. See [DateTime](docId\:dX1C8uSfkXPwntpRb9f-T) for more information about this data type.