Titanium.Platform

Note that the displayCaps property begins with a lowercase letter, which differentiates it from the DisplayCaps object that it returns.

On Android, this may be the UDID (unique device ID). For iOS, this is a unique identifier for this install of the application.

Previously on iOS this may have been a UDID, but access to this has been restricted by Apple. For more information, see UUID Article on NSHipster documentation.

To use a UUID across different applications of the same vendor, use Titanium.Platform.identifierForVendor instead.

To use a UUID for tracking / advertising purposes, use Titanium.Platform.identifierForAdvertising instead.

Unlike the Titanium.Platform.identifierForVendor property, the same value is returned to all vendors. This identifier may change, for example, if the user erases the device, so you should not cache it.

In iOS 10.0 and later, the value of this property is all zeroes when the user has limited ad tracking.

If the value is null, wait and get the value again later. This happens, for example, after the device has been restarted but before the user has unlocked the device.

The value of this property is the same for apps that come from the same vendor running on the same device. A different value is returned for apps on the same device that come from different vendors, and for apps on different devices regardless of vendor. See the Apple docs for more infos.

Check the value of this property before performing any advertising tracking. If the value is false, use the advertising identifier only for the following purposes: frequency capping, attribution, conversion events, estimating the number of unique users, advertising fraud detection, and debugging.

Use this utility property to guard API's that may not be available on a non-iOS device, e.g. motion activity or some authorization components.

Locale, as a combination of ISO 2-letter language and country codes. For example, en-US or en-GB. See the ISO 639-1 and ISO 3166-1 alpha-2 sections of wikipedia for reference.

On iOS, this value is the app's UUID. Apple does not allow access to any hardware identifier information as it can be used for unique device identification, which they have prohibited.

Returns the manufacturer of the device, for example, motorola. Virtual devices return unknown.

An identifier of the hardware model of the device. For example, HTC Sensation Z710e.

Virtual devices will also return a value. For example, sdk for the standard Android SDK and google_sdk for the enhanced Android Google APIs SDK running in an emulator, and Simulator for iOS running in a simulator.

if (Ti.Platform.model.indexOf('Simulator') !== -1 || Ti.Platform.model.indexOf('sdk') !== -1 ){
  alert('Accelerometer does not work on a virtual device');
} else {
  // Add Accelerometer event listener
}

On iOS this is "javascriptcore", on Android either "v8" or "rhino".

Important: When developing for the Apple ecosystem, using this API requires the NSPrivacyAccessedAPICategorySystemBootTime property set in the privacy manifest that was introduced in iOS 17. You can learn more about it here.

This returns the same value as the OS_VERSION_MAJOR constant.

This returns the same value as the OS_VERSION_MINOR constant.

Will return zero if the OS does not have a minor version.

This returns the same value as the OS_VERSION_PATCH constant.

Will return zero if the OS does not have a patch version.

As of iOS 9, this method may return false if you have not added the URL schemes you query to the "tiapp.xml" file. You can do this by adding a <key>LSApplicationQueriesSchemes</key> plist section as shown here.

As of Android 11, this method may return false if you have not added the URL schemes to a <queries/> manifest section in the "tiapp.xml" file. Google documents examples how to do this here.

<ti:app xmlns:ti="http://ti.titaniumsdk.com">
    <android>
        <manifest xmlns:android="http://schemas.android.com/apk/res/android">
            <queries>
                <!-- Allows "http://" and "https://" web URLs. -->
                <intent>
                    <action android:name="android.intent.action.VIEW"/>
                    <data android:scheme="https"/>
                </intent>
                <!-- Allows "mailto:" URLs to an e-mail app. -->
                <intent>
                    <action android:name="android.intent.action.VIEW"/>
                    <data android:scheme="mailto"/>
                </intent>
                <!-- Allows file URLs to local image files. -->
                <intent>
                    <action android:name="android.intent.action.VIEW"/>
                    <data android:mimeType="image/*"/>
                </intent>
            </queries>
        </manifest>
    </android>
</ti:app>

This is intended to provide an implementation similar to Node's os.cpus().

Here are some example URL strings this can be set to.

• 'https://www.titaniumsdk.com' (Opens in web browser.)
• 'mailto:user@domain.com' (Opens a new draft in e-mail app.)
• 'mailto:user@domain.com?cc=johndoe@domain.com,janedoe@domain.com&subject=My%20Subject&body=The%20body.'
• 'tel:123-456-7890' (Opens phone app if applicable.)
• 'geo:37.774,-122.431?z=12' (Opens map on Android.)
• 'maps:?address=London,UK' (Opens map on iOS.)

You can use the Titanium.Platform.canOpenURL method to determine if the system has a registered application for the given URL before invoking the Titanium.Platform.openURL method.

iOS Note: For iOS 10 and later, this method is performed asynchronously and will call the function passed as an (optional) third parameter instead of returning a boolean synchronously.

Example:

Ti.Platform.openURL('myapp://', {
  'UIApplicationOpenURLOptionUniversalLinksOnly': true
}, function(e) {
  Ti.API.info('URL open successfully? ' + e.success);
});