Device Functions

Overview

• Device module functions are related to device information
• The device module uses the device prefix

device.getDeviceId Get Device ID

• Get the device ID
• Available in EC standalone 2.0.0+; requires the standalone activator to obtain the device ID correctly
• See Advanced — Standalone Activator Tutorial
• @return string

1
function main() {
2
    var xx = device.getDeviceId();
3
    logd(xx);
4
}
5

6
main();

device.getEcid Get ECID

• Get ECID
• Available in EC standalone 3.11.0+; requires the standalone activator to obtain the device ID correctly
• See Advanced — Standalone Activator Tutorial
• @return string

1
function main() {
2
    var xx = device.getEcid();
3
    logd(xx);
4
}
5

6
main();

device.getSerialNo Get Serial Number

• Get serial number
• Available in EC standalone 3.11.0+; requires the standalone activator to obtain the device ID correctly
• See Advanced — Standalone Activator Tutorial
• @return string

1
function main() {
2
    var xx = device.getSerialNo();
3
    logd(xx);
4
}
5

6
main();

device.getDeviceName Get Device Name

• Get device name (the phone’s name)
• @return string

1
function main() {
2
    var xx = device.getDeviceName();
3
    logd(xx);
4
}
5

6
main();

device.getDeviceName2 Get Device Name 2

• Get device name; on iOS 16+ the standard method may fail — use this function instead
• Available in EC standalone 2.0.0+; requires the standalone activator to obtain the device name correctly
• See Advanced — Standalone Activator Tutorial
• @return string

1
function main() {
2
    var xx = device.getDeviceName2();
3
    logd(xx);
4
}
5

6
main();

device.getScreenWidthHeight Screen Width and Height

• Screen width and height
• @return integer

1
function main() {
2
    let aa = device.getScreenWidthHeight()
3
    logd("getScreenWidthHeight " + aa)
4
    let bb = aa.split(",")
5
    logd("width " + bb[0])
6
    logd("height " + bb[1])
7
}
8

9
main();

device.getScreenWidth Screen Width

• [Deprecated]
• Get screen width
• @return integer

1
function main() {
2
    var width = device.getScreenWidth();
3
    logd(width);
4
}
5

6
main();

device.getScreenHeight Screen Height

• [Deprecated]
• Get screen height
• @return integer

1
function main() {
2
    var height = device.getScreenHeight();
3
    logd(height);
4
}
5

6
main();

device.getScale Screen Scale Factor

• Screen scale factor
• @return {float}

1
function main() {
2
    var d = device.getScale();
3
    logd(d);
4
}
5

6
main();

device.getModel Get Device Model

• Get phone model
• @return string

1
function main() {
2
    var model = device.getModel();
3
    logd(model);
4
}
5

6
main();

device.getOSVersion Get OS Version

• @return string

1
function main() {
2
    var osVersion = device.getOSVersion();
3
    logd(osVersion);
4
}
5

6
main();

device.getBattery Get Battery Level

• Get battery level
• @return int

1
function main() {
2
    var res = device.getBattery();
3
    logd(res);
4
}
5

6
main();

device.isCharging Is Charging

• Whether the device is charging
• @return boolean

1
function main() {
2
    var res = device.isCharging();
3
    logd(res);
4
}
5

6
main();