Object “device”

Object > NativeObject > Device

Provides information about the device that executes the application.

Type: Device extends NativeObject
Constructor: private
Singleton: device
Namespace: tabris
Direct subclasses: None
JSX Support: No

See also:

JSX Reading various device properties [► Run in Playground]

Properties

cameras

An array of Camera objects ordered by priority. The first entry is considered the primary camera of the device.

Type: Camera[]
Settable: No
Change Event: Not supported

language

The user language configured on the device as an RFC 4646 compliant string. For example "de", "es-ES", etc. This property is also available globally as navigator.language. Note: On iOS ≥ 11 it will only return languages declared in CFBundleLocalizations.

Type: string
Settable: No
Change Event: Not supported

model

The name of the device model. For example "iPad4,1" or "Nexus 7". This property is also available globally as device.model.

Type: string
Settable: No
Change Event: Not supported

name

The name of the device set by owner. For example "John's phone". This property is also available globally as device.name.

Note: On Android name is only available on Android 7.1+.

Type: string
Settable: No
Change Event: Not supported

orientation

The device orientation. One of portrait-primary, portrait-secondary, landscape-primary, and landscape-secondary.

Type: 'portrait-primary' | 'portrait-secondary' | 'landscape-primary' | 'landscape-secondary'
Settable: No
Change Event: orientationChanged

platform

The name of the platform. Either "Android" or "iOS". This property is also available globally as device.platform.

Type: 'Android' | 'iOS'
Settable: No
Change Event: Not supported

scaleFactor

The ratio between physical pixels and device independent pixels. This property is also available globally as window.devicePixelRatio.

Type: number
Settable: No
Change Event: Not supported

screenHeight

The entire height of the device’s screen in device independent pixel. Depends on the current device orientation. This property is also available globally as screen.height.

Type: number
Settable: No
Change Event: Not supported

screenWidth

The entire width of the device’s screen in device independent pixel. Depends on the current device orientation. This property is also available globally as screen.width.

Type: number
Settable: No
Change Event: Not supported

vendor

The name of the device manufacture. For example "Samsung" or "Apple". This property is also available globally as device.vendor.

Type: string
Settable: No
Change Event: Not supported

version

The platform version. On iOS it looks like this: "8.1.1". On Android, the version code is returned. This property is also available globally as device.version.

Type: string
Settable: No
Change Event: Not supported

Change Events

orientationChanged

Fired when the orientation property has changed and the rotation animation has finished.

EventObject Type: PropertyChangedEvent<Device, string>

Property Type Description
value string The new value of orientation.