1. Introduction
ZEASN developed a device info API which can be used to identify the client devices and show key device properties. This document describes the available properties and how to get access to them.
2. Device info API
The Device info API can only be used on a real ZEASN certified device. In case it was used on a non-ZEASN certified device, the property will be set to “unknown” which is a default value.
Category | Field | Default value | Description | Example values |
Channel | appStore | Zeasn | Zeasn | |
Channel | vendor | unknown | The company who manufactured the device | TCL; Haier; Konka; TPV; CVTE; Vestel;Skyworth; Moka it can be used for statistics purpose; |
Channel | brand | unknown | The company who sells the device | TCL; Haier; Konka; Philips; Philco; Thomson;OEM; it can be used for statistics purpose; |
Product | platform | unknown | Similar like product cateogory | V8NT671LALF, WHALEOSSKWNT6904KTV, TPM196E |
Product | year | unknown | The first year start to sell the product; | 2014;2015;2016;2017;2018; |
Product | deviceId | unknown | The unique identify for the device | MAC; Serial No; something unique; |
Product | WhaleAdID | unknown | Resettable Advertisement ID | adc1e1cb-2c81-4639-bb21-166891d50dd1 |
Product | firmwareComponentID | unknown | Device Firmware Component ID | V8NT671LALF1, WHALEOSSKWNT6904KTV, TPM196E00001 |
Product | firmwareVersion | unknown | The installed firmware version number | 107.000.043.000 |
Capability | os | unknown | TV operation system | Android; Linux; AOSP; |
Capability | browserEngine | unknown | Presto; Blink; | |
Capability | hasStorage | unknown | True; False; | |
Capability | support3d | unknown | True; False; | |
Capability | supportUHD | unknown | True; False; | |
Capability | supportHDR | unknown | True; False; | |
Capability | supportWebSocket | unknown | True; False; | |
Capability | supportPlayready | unknown | True; False; | |
Capability | supportWidevineModular | unknown | True; False; | |
Capability | supportWidevineClassic | unknown | True; False; | |
Capability | supportAdobeHDS | unknown | True; False; | |
Capability | supportAppleHLS | unknown | True; False; | |
Capability | supportMSSmoothStreaming | unknown | True; False; | |
Capability | supportMPEG_DASH | unknown | True; False; | |
Capability | drmMethod | unknown | OIPF; EME; | |
Capability | supportOIPF | unknown | True; False; | |
Capability | supportEME | unknown | True; False; |
To be able to access the device info, you have to add an external JS file which will allow you to read them via an external object.
<script src="<base_URL>zeasn_deviceInfo_sdk.js" type="text/javascript" />
· PROD: https://cache.zeasn.tv/webstatic/homepage_web/deviceinfo/zeasn_deviceInfo_sdk.js
After adding this external JS file, you will be able to read the properties using an object "DeviceInfo" and sub objects "Channel", "Product" and "Capability". The properties can be read using the object as below using callback "window.onDeviceInfoReady".
Example to show all properties:
window.onDeviceInfoReady(function(DeviceInfo) { logEl.innerHTML = JSON.stringify(DeviceInfo, null, 2) })
DeviceInfo.Channel.appStore;
DeviceInfo.Product.year;
DeviceInfo.Capability.support3d;
Based on device info properties, app providers can do the diversity handling.
Properties | Properties |
DeviceInfo.Channel.appStore | DeviceInfo.Capability.supportUHD |
DeviceInfo.Channel.vendor | DeviceInfo.Capability.supportHDR |
DeviceInfo.Channel.brand | DeviceInfo.Capability.supportWebSocket |
DeviceInfo.Product.platform | DeviceInfo.Capability.supportPlayready |
DeviceInfo.Product.year | DeviceInfo.Capability.supportWidevineModular |
DeviceInfo.Product.deviceID | DeviceInfo.Capability.supportWidevineClassic |
DeviceInfo.Product.firmwareVersion | DeviceInfo.Capability.supportAdobeHDS |
DeviceInfo.Capability.os | DeviceInfo.Capability.supportAppleHLS |
DeviceInfo.Capability.browserEngine | DeviceInfo.Capability.supportMSSmoothStreaming |
DeviceInfo.Capability.hasStorage | DeviceInfo.Capability.supportMPEG_DASH |
DeviceInfo.Capability.support3d | DeviceInfo.Capability.drmMethod |
The ZEASN device ID information can be in different formats, some of the formats are out of our control because they are provided by the Smart TV manufacturers in their own format and by their own local objects. If there is no possible way of uniquely identifying devices based on a unique identifier from the manufacturer, we provide it by creating a unique cookie value. Serving as the ZEASN fallback mechanism.
The ZEASN fallback will generate a unique value. Example: 663653e7-f9a7-8721-43b0-ff9de6250668
Possible formats:
Brand | Example | Type |
Philips | 0008c60000123456 | Permanent |
AOC | bcb1810000789101 | Permanent |
TCL | 52652476 | Permanent/Cookie * |
Haier | zeasn-663653e7-f9a7-8721-43b0-ff9de6250668 | Cookie |
* depending TV models and years it could happen that older devices do not yet have a value from the manufacturer of the device.