Advanced Unity Mobile Scripting

Device Properties

There are a number of device-specific properties that you can access:-

SystemInfo.deviceUniqueIdentifierUnique device identifier.
SystemInfo.deviceNameUser specified name for device.
SystemInfo.deviceModelDevice Model.
SystemInfo.operatingSystemOperating system name and version.

Anti-Piracy Check

Pirates will often hack an application (by removing AppStore DRM protection) and then redistribute it for free. Unity comes with an anti-piracy check which allows you to determine if your application was altered after it was submitted to the AppStore.

You can check if your application is genuine (not-hacked) with the Application.genuine property. If this property returns false then you might notify user that he is using a hacked application or maybe disable access to some functions of your application.

Note: Application.genuineCheckAvailable should be used along with Application.genuine to verify that application integrity can actually be confirmed. Accessing the Application.genuine property is a fairly expensive operation and so you shouldn't do it during frame updates or other time-critical code.

Vibration Support

You can trigger a vibration by calling Handheld.Vibrate. However, devices lacking vibration hardware will just ignore this call.

Activity Indicator

Mobile OSes have builtin activity indicators, that you can use during slow operations. Please check Handheld.StartActivityIndicator docs for usage sample.

Screen Orientation

Unity iOS/Android allows you to control current screen orientation. Detecting a change in orientation or forcing some specific orientation can be useful if you want to create game behaviors depending on how the user is holding the device.

You can retrieve device orientation by accessing the Screen.orientation property. Orientation can be one of the following:

PortraitThe device is in portrait mode, with the device held upright and the home button at the bottom.
PortraitUpsideDownThe device is in portrait mode but upside down, with the device held upright and the home button at the top.
LandscapeLeftThe device is in landscape mode, with the device held upright and the home button on the right side.
LandscapeRightThe device is in landscape mode, with the device held upright and the home button on the left side.

You can control screen orientation by setting Screen.orientation to one of those, or to ScreenOrientation.AutoRotation. When you want auto-rotation, you can disable some orientation on case by case basis

Screen.autorotateToPortraitAllow portrait orientation.
Screen.autorotateToPortraitUpsideDownAllow portrait upside-down orientation.
Screen.autorotateToLandscapeLeftAllow landscape left orientation.
Screen.autorotateToLandscapeRightAllow landscape right orientation.

iOS

Advanced iOS scripting

Determining Device Generation

Different device generations support different functionality and have widely varying performance. You should query the device's generation and decide which functionality should be disabled to compensate for slower devices. You can find the device generation from the iPhone.generation property.

More information about different device generations, performance and supported functionality can be found in our iPhone Hardware Guide.

Android

Advanced Android scripting

Determining Device Generation

Different Android devices support different functionality and have widely varying performance. You should target specific devices or device families and decide which functionality should be disabled to compensate for slower devices. There are a number of device specific properties that you can access to which device is being used.

Note: Android Marketplace does some additional compatibility filtering, so you should not be concerned if an ARMv7-only app optimised for OGLES2 is offered to some old slow devices.

Page last updated: 2013-02-25