Crafty.device

src/inputs/device.js#L5-L11

Methods relating to devices such as tablets or phones

Properties

Methods

Back to top

Crafty.mobile

src/core/extensions.js#L21-L36

Determines if Crafty is running on mobile device.

If Crafty.mobile is equal true Crafty does some things under hood:

- set viewport on max device width and height
- set Crafty.stage.fullscreen on true
- hide window scrollbars
Back to top

Crafty.device.deviceMotion()

src/inputs/device.js#L125-L153
public Crafty.device.deviceMotion(Function callback)
callback

Callback method executed once as soon as device motion is change

Do something with normalized device motion data:

{
    acceleration : 'Grab the acceleration including gravity from the results',
    rawAcceleration : 'Display the raw acceleration data',
    facingUp : 'Z is the acceleration in the Z axis, and if the device is facing up or down',
    tiltLR : 'Convert the value from acceleration to degrees. acceleration.x is the acceleration according to gravity, we'll assume we're on Earth and divide by 9.81 (earth gravity) to get a percentage value, and then multiply that by 90 to convert to degrees.',
    tiltFB : 'Convert the value from acceleration to degrees.'
}

Example

// Get DeviceMotion event normalized data.
Crafty.device.deviceMotion(function(data){
    Crafty.log('data.moAccel : '+data.rawAcceleration+', data.moCalcTiltLR : '+Math.round(data.tiltLR)+', data.moCalcTiltFB : '+Math.round(data.tiltFB)+'');
});

See browser support at http://caniuse.com/#search=motion.

Back to top

Crafty.device.deviceOrientation()

src/inputs/device.js#L84-L111
public Crafty.device.deviceOrientation(Function callback)
callback

Callback method executed once as soon as device orientation is change

Do something with normalized device orientation data:

{
  tiltLR    :   'gamma -- the angle in degrees the device is tilted left-to-right.',
  tiltFB    :   'beta -- the angle in degrees the device is tilted front-to-back',
  dir       :   'alpha -- the direction the device is facing according to the compass',
  motUD     :   'The angle's values increase as you tilt the device to the right or towards you.'
}

Example

// Get DeviceOrientation event normalized data.
Crafty.device.deviceOrientation(function(data){
    Crafty.log('data.tiltLR : '+Math.round(data.tiltLR)+', data.tiltFB : '+Math.round(data.tiltFB)+', data.dir : '+Math.round(data.dir)+', data.motUD : '+data.motUD+'');
});

See browser support at http://caniuse.com/#search=device orientation.