PhoneGap: Accessing Device Capabilities This presentation has been developed in the context of the Mobile Applications Development course, DISIM, University of L'Aquila (Italy), Spring 2013. http://www.ivanomalavolta.com

3. navigator.device.capture
•
•
•

4. navigator.device.capture

5. –
–
–
–
–

7. var imageModes =
navigator.device.capture.supportedImageModes;
for each (var mode in imageModes) {
console.log(mode.type);
console.log(mode.height);
console.log(mode.width);
}

8. capture

11. • 
• 

12. var options = { limit: 2, duration: 5 };
navigator.device.capture.captureAudio(win, fail, options);
function win(mediaFiles) {
var i;
for (i=0; i<mediaFiles.length; i++) {
console.log(mediaFiles[i]);
}
}
function fail(error) {
console.log(„Error with code: ' + error.code);
}

15. captureAudio

16. • 

17. var options = { limit: 3};
navigator.device.capture.captureImage(win, fail,
options);
function win(mediaFiles) {
var i;
for (i=0; i<mediaFiles.length; i++) {
upload(mediaFiles[i]);
}
}
function fail(error) {
console.log(„Error with code: ' + error.code);
}

20. captureAudio

21. • 
• 

22. navigator.device.capture.captureVideo(win, fail, {});
function win(mediaFiles) {
var i;
for (i=0; i<mediaFiles.length; i++) {
upload(mediaFiles[i]);
}
}
function fail(error) {
console.log(„Error with code: ' + error.code);
}

26. CaptureError.CAPTURE_INTERNAL_ERR
CaptureError.CAPTURE_APPLICATION_BUSY
CaptureError.CAPTURE_INVALID_ARGUMENT
CaptureError.CAPTURE_NO_MEDIA_FILES
CaptureError.CAPTURE_NOT__SUPPORTED

29. getPicture()
•
•


37. navigator.camera.getPicture(win, fail,
{ quality: 50,
destinationType: destinationType.FILE_URI,
pictureSource.PHOTOLIBRARY
});
function win(imageURI) {
var element = $(“#block”);
element.src(imageURI);
}
// fail function omitted here

39. navigator.contacts
navigator.contacts
•
•

40. navigator.contacts.create(properties)

41. navigator.contacts.create(properties)
properties
var contact = navigator.contacts.create({
"displayName": “Ivano“
});

42. contacts.find

44. •
•
•

45. var contact = navigator.contacts.create({
"displayName": “Ivano“
});
var name = new ContactName();
name.givenName = “Ivano“;
name.familyName = “Malavolta“;
contact.name = name;
contact.birthday = new Date(“19 July 1983");
contact.save(win, fail);
function win(contact) {
alert("Save Success");
};
function fail(contactError) {
alert("Error = " + contactError.code);
};

46. navigator.contacts.find(
contactFields,
contactSuccess,
contactError,
contactFindOptions
);

48. var fields = ["displayName", "name"]; // or [“*”]
navigator.contacts.find(fields, win, fail);
function win(contacts) {
console.log(„ok');
};
function fail(err) {
console.log(err.code);
};

50. var options = new ContactFindOptions();
options.filter = “Ivano";
options.multiple = true;
filter = ["displayName",“birthday"];
navigator.contacts.find(filter, win, fail, options);
function win(contacts) {
for (var i=0; i<contacts.length; i++) {
console.log(contacts[i].displayName);
}
};
function fail(contactError) {
alert("Error = " + contactError.code);
};

51. fail
ContactError.UNKNOWN_ERROR
ContactError.INVALID_ARGUMENT_ERROR
ContactError.TIMEOUT_ERROR
ContactError.PENDING_OPERATION_ERROR
ContactError.IO_ERROR
ContactError.NOT_SUPPORTED_ERROR
ContactError.PERMISSION_DENIED_ERROR

53. – ontouchstart, onclick, ...

54. document.addEventListener(EVENTNAME, onEvent, false);
function onEvent() {
// handle the event
}

55. • deviceready
• pause, resume
• online, offline
• batterycritical, batterylow, batterystatus
• backbutton, menubutton, searchbutton
• startcallbutton, endcallbutton
• volumedownbutton, volumeupbutton

56. •
•
deviceready

57. pause
resume

58. online
offline

59. navigator.network.connection
type
Connection.UNKNOWN
Connection.ETHERNET
Connection.WIFI
Connection.CELL_2G
Connection.CELL_3G
Connection.CELL_4G
Connection.NONE

60. batterycritical
batterylow
batterycritical
batterystatus

62. backbutton
menubutton
searchbutton

64. •
•
•
•
•

65. navigator.notification.alert(message,
callback, [title], [button])
•
•
•
•

66. navigator.notification.alert(message,
callback, [title], [buttons])
•
•
–
•
•

67. navigator.notification.prompt(message,
callback, [title], [buttons])
•
•
–
•
•

68. navigator.notification.beep(times)
•

69. navigator.notification.vibrate(milliseconds)
•

71. navigator.accelerometer
•
•
•

72. getCurrentAcceleration(win, fail);

73. var watchID =
navigator.accelerometer.watchAcceleration(win, fail,
[options]);

74. clearWatch(watchID);

75. these values include the effect of
gravity (9.81 m/s^2)

76. var options = { frequency: 3000 };
var watchID = navigator.accelerometer.watchAcceleration(win, fail,
options);
function win(acc) {
if((acc.x == 0) && (acc.y == 0) && (acc.z == 9,81)) {
console.log(“I am on a table”);
stop();
}
}
function fail() {
console.log(“error”);
}
function stop() {
if(watchID) {
navigator.accelerometer.clearWatch(watchID);
watchID = null;
}
}

77. var previousReading = {x: null, y: null, z: null};
navigator.accelerometer.watchAcceleration(function (reading) {
var changes = {},
bound = 3;
if (previousReading.x !== null) {
changes.x = Math.abs(previousReading.x, reading.x);
changes.y = Math.abs(previousReading.y, reading.y);
changes.z = Math.abs(previousReading.z, reading.z);
}
if (changes.x > bound && changes.y > bound && changes.z > bound) {
console.log(“shake detected”);
}
previousReading = {
x: reading.x,
y: reading.y,
z: reading.z
}
}, null, { frequency: 300 });