Copyright 2012, Oracle and/or its affiliates. All rights reserved.

Transcription

1 1

2 Integrating Device Services with ADF Mobile 2

3 Apache Cordova / PhoneGap ADF Mobile utilizes PhoneGap to access most of the onboard devices services To be replaced by Apache Cordova soon Provides access to: Device Properties SMS and (Not through PhoneGap) Contacts Camera and Photo Library Geolocation 3

4 Overview Accessing Device Services 1. Data Controls 2. Implicit EL Objects 3. Programmatic APIs 4

5 Overview Accessing Device Services 1. Data Controls 2. Implicit EL Objects 3. Programmatic APIs Found in the Data Control Palette Drag n drop services onto a page Take the grunt work out of coding calls to the API and constructing the necessary screens 5

6 Overview Accessing Device Services 1. Data Controls 2. Implicit EL Objects 3. Programmatic APIs Provide easy access to device properties Referenced via the UI components Simply type or use the Expression Builder #{devicescope.device.hascontacts} 6

7 Overview Accessing Device Services 1. Data Controls 2. Implicit EL Objects 3. Programmatic APIs Provide programmers the flexibility of accessing device services from Java with their own Java Beans Easier to handle error conditions and process any outputs DeviceManager dm = DeviceManagerFactory.getDeviceManager(); dm.send ("foo@bar.com","joe.jones@corp.com", "Test ", "Test message", null, null, null); 7

8 Device Service Accessible from JavaScript Access device services from non AMX pages Remote URL Local HTML Add JavaScript library to your page Direct access to invoke device features Use adf.mf.api.* adf.mf.api.sendsms({to: " ", body: "This is a test message"}); 8

9 9

10 Accessing Device Properties Service Data Control EL Access Programmatic Device Properties Yes Yes 10

11 Property Static/Dyna mic EL Expression Sample Value Java API device.name Static #{devicescope.device.name} "Joe Smith's iphone" DeviceManager.getName() device.platform Static #{devicescope.device.platform} "iphone" DeviceManager.getPlatform() device.version Static #{devicescope.device.version} "4.3.2", "5.0.1" DeviceManager.getVersion() device.os Static #{devicescope.device.os} "ios" DeviceManager.getOs() device.model Static #{devicescope.device.model} "i386", "iphone3,1" DeviceManager.getModel() device.phonegap Static #{devicescope.device.phonegap} "1.0.0" DeviceManager.getPhonegap() hardware.hascamera Static #{devicescope.hardware.hascamera} true, false DeviceManager.hasCamera() hardware.hascontacts Static #{devicescope.hardware.hascontacts} true, false DeviceManager.hasContacts() hardware.hastouchscreen Static #{devicescope.hardware.hastouchscreen} true, false DeviceManager.hasTouchScreen() hardware.hasgeolocation Static #{devicescope.hardware.hasgeolocation} true, false DeviceManager.hasGeolocation() hardware.hasaccelerometer Static #{devicescope.hardware.hasaccelerometer} true, false DeviceManager.hasAccelerometer() hardware.hascompass Static #{devicescope.hardware.hascompass} true, false DeviceManager.hasCompass() hardware.hasfileaccess Static #{devicescope.hardware.hasfileaccess} true, false DeviceManager.hasFileAccess() hardware.haslocalstorage Static #{devicescope.hardware.haslocalstorage} true, false DeviceManager.hasLocalStorage() hardware.hasmediaplayer Static #{devicescope.hardware.hasmediaplayer} true, false DeviceManager.hasMediaPlayer() hardware.hasmediarecorder Static #{devicescope.hardware.hasmediarecorder} true, false DeviceManager.hasMediaRecorder() hardware.networkstatus Dynamic #{devicescope.hardware.networkstatus} "wifi","2g","unknown" DeviceManager.getNetworkStatus() hardware.screen.width Dynamic #{devicescope.hardware.screen.width} 320, 480 DeviceManager.getScreenWidth() hardware.screen.height Dynamic #{devicescope.hardware.screen.height} 480, 320 DeviceManager.getScreenHeight() hardware.availablewidth Dynamic #{devicescope.hardware.availablewidth} <= 320, <= 480 DeviceManager.getAvailableScreenWidth() hardware.availableheight Dynamic #{devicescope.hardware.availableheight} <= 480, <= 320 DeviceManager.getAvailableScreenHeight() hardware.screen.dpi Static #{devicescope.hardware.screen.dpi} 160, 326 DeviceManager.getScreenDpi() hardware.screen.diagonalsize Static #{devicescope.hardware.screen.diagonalsize} 9.7, 6.78 DeviceManager.getScreenDiagonalSize() 11 hardware.screen.scalefactor Static #{devicescope.hardware.screen.scalefactor} 1.0, 2.0 DeviceManager.getScreenScaleFactor()

12 PRODUCT DEMONSTRATION ACCESSING DEVICE PROPERTIES via EL Expression 12

13 13

14 14

15 15

16 16

17 PRODUCT DEMONSTRATION ACCESSING DEVICE PROPERTIES via a Java Bean 17

18 Device Properties API Example 01 public class MyBean { // Called via a button 04 public void actionsendsms(actionevent event) { 05 DeviceManager device = DeviceManagerFactory.getDeviceManager(); boolean hascamera = device.hascamera(); 08 } 18

19 Accessing Device Properties Service Data Control EL Access Programmatic Device Properties Yes Yes Send SMS Yes Yes 19

20 PRODUCT DEMONSTRATION SENDING SMS via the Data Control 20

21 21

22 22

23 23

24 24

25 25

26 26

27 PRODUCT DEMONSTRATION SENDING SMS via a Java Bean 27

28 Send SMS API 01 public class oracle.adf.model.datacontrols.device.devicemanager { /** 04 * Display the operating system's default UI for sending a text 05 * message, and optionally pre-populate certain fields 06 * 07 to - recipient list (comma-separated) 08 body - text of message 09 */ 10 public void sendsms(java.lang.string to, java.lang.string body) 28

29 Send SMS API Example 01 public class MyBean { // Called via a button 04 public void actionsendsms(actionevent event) { 05 DeviceManager device = DeviceManagerFactory.getDeviceManager(); String to = " , "; 08 String body = "A test SMS"; device.sendsms(to, body); 11 } 12 } 29

30 30

31 31

32 32

33 33

34 34

35 35

36 36

37 37

38 38

39 39

40 40

41 41

42 Accessing Device Properties Service Data Control EL Access Programmatic Device Properties Yes Yes Send SMS Yes Yes Send Yes Yes 42

43 PRODUCT DEMONSTRATION SENDING via the Data Control 43

44 44

45 45

46 46

47 47

48 48

49 PRODUCT DEMONSTRATION SENDING via a Java Bean 49

50 Send API 01 public class oracle.adf.model.datacontrols.device.devicemanager { /** Display the operating system's default UI for sending an , and 04 * optionally pre-populate certain fields. 05 * 06 to - recipient list (comma-separated) 07 cc - carbon copy recipient list (comma-separated) 08 subject - subject line 09 body - text of 10 bcc - blind carbon copy recipient list (comma-separated) 11 attachments - list of files to attach (comma-separated). Must be 12 * specified as absolute filenames; 13 mimetypes - list of MIME types, specified in the same order as 14 * the list of attachments. 15 */ 16 public void send (java.lang.string to, java.lang.string cc, 17 java.lang.string subject, java.lang.string body, 18 java.lang.string bcc, java.lang.string attachments, 19 java.lang.string mimetypes) 50

51 Send API Example 01 public class MyBean { // Called via a button 04 public void actionsend (actionevent event) { 05 DeviceManager device = DeviceManagerFactory.getDeviceManager(); String to = "steven.king@oracle.com, neena.kochrar@oracle.com"; 08 String cc = "scott.tiger@oracle.com"; 09 String subject = "A test subject"; 10 String body = "A test body"; device.send (to, cc, subject, body, null, null, null); 13 } 14 } 51

52 52

53 53

54 54

55 55

56 56

57 57

58 58

59 59

60 60

61 61

62 62

63 Accessing Device Properties Service Data Control EL Access Programmatic Device Properties Yes Yes Send SMS Yes Yes Send Yes Yes Create Contact Find Contacts Update Contact Remove Contact Yes Yes Yes Yes Yes 63

64 Working with Contacts Operations Find Contacts Create Contact Update Contacts Remove Contact Both update and remove operations use a Contact object as a parameter retrieved from a findcontact operation ADF Mobile provides a contact related objects 64

65 PRODUCT DEMONSTRATION WORKING WITH CONTACTS via the Data Control 65

66 66

67 67

68 68

69 PRODUCT DEMONSTRATION WORKING WITH CONTACTS via a Java Bean 69

70 Create Contact API 01 public class oracle.adf.model.datacontrols.device.devicemanager { /** Save a previously-created Contact to the device's address book 04 * Note that you can create a Contact by simply instantiating one 05 * and setting its properties, but in order to persist it, you 06 * must call createcontact. 07 * 08 contact - a previously-constructed Contact object 09 - a Contact object. Note that you should always 10 * use the returned Contact object in subsequent 11 * operations, because this object will have the 12 * requisite primary key 13 */ 14 public Contact createcontact(contact contact) 70

71 Create Contact API Example 01 public class MyBean { public void actioncreatecontact(actionevent event) { 04 DeviceManager device = DeviceManagerFactory.getDeviceManager(); Contact contact = new Contact(); 07 contactname contactname = new ContactName(); 08 contactname.setfamilyname("doe"); 09 contactname.setgivenname("joe"); 10 contact.setname(contactname); 11 ContactField phoneno = new ContactField(); 12 phoneno.settype("mobile"); 13 phoneno.setvalue(" "); 14 ContactField[] phonenos = new ContactField[] { phoneno }; 15 contact.setphonenumbers(phonenos); Contact newcontact = device.createcontact(contact); 18 } 71

72 01 public class oracle.adf.model.datacontrols.device.devicemanager { /** Enables retrieval of one or more Contact objects matching the criteria. 04 * 05 contactfields - comma-delimited list of field names to match on, 06 * e.g. "id,displayname,name,nickname. 07 filter - search criteria. It is matched against all fields 08 * specified in contactfields 09 multiple - return multiple contacts or first found 10 - an array of Contact objects. Note that each 11 * Contact object will ONLY contain the fields you 12 * specified in the contactfields parameter; all 13 * others will be empty/null 14 */ Find Contacts API 15 public Contact[] findcontacts(java.lang.string contactfields, 16 java.lang.string filter, boolean multiple) 72

73 Find Contacts API Example 01 public class MyBean { public void actionfindcontacts(actionevent event) { 04 DeviceManager device = DeviceManagerFactory.getDeviceManager(); 05 // This will return just one contact with only the ID field: 06 Contact[] foundcontacts1 = device.findcontacts("", "", false); 07 // This will return all contacts with only ID fields: 08 Contact[] foundcontacts2 = device.findcontacts("", "", true); 09 // This will return just one contact with all fields: 10 Contact[] foundcontacts3 = device.findcontacts("*", "", false); 11 // This will return all contacts with all fields: 12 Contact[] foundcontacts4 = device.findcontacts("*", "", true); String fields = "name,phonenumbers, s,addresses"; 15 String filter = "Smith"; 16 Contact[] contacts = device.findcontacts(fields, filter, true); 17 } 73

74 Update Contact API 01 public class oracle.adf.model.datacontrols.device.devicemanager { /** Update an existing Contact object. Note that you can modify a 04 * Contact via its various properties and methods, but in order to 05 * persist the changes, you must call updatecontact. 06 * 07 acontact the modified Contact object to persist in the 08 * device's address book the modified Contact object. 10 */ 11 public Contact updatecontact(contact acontact) 74

75 01 public class MyBean { public void actionupdatecontact(actionevent event) { 04 DeviceManager device = DeviceManagerFactory.getDeviceManager(); Contact[] contacts = device.findcontacts("name", "Smith", true); 07 // Assuming only 1 record returned 08 contacts[0].getphonenumbers()[0].setvalue(" "); 09 contacts[0].get s()[0].settype("work"); 10 contacts[0].getaddresses()[0].setpostalcode("94065"); Contact updatedcontact = device.updatecontact(contacts[0]); 13 } 14 } Update Contact API Example 75

76 Remove Contact API 01 public class oracle.adf.model.datacontrols.device.devicemanager { /** Remove a contact from the address book. 04 * 05 acontact the Contact object to remove. 06 */ 07 public void removecontact(contact acontact); 76

77 Remove Contact API Example 01 public class MyBean { public void actionremovecontact(actionevent event) { 04 DeviceManager device = DeviceManagerFactory.getDeviceManager(); Contact[] contacts = device.findcontacts("name", "Smith", true); 07 // Assuming only 1 record returned 08 device.removecontact(contacts[0]); 09 } 10 } 77

78 Accessing Device Properties Service Data Control EL Access Programmatic Device Properties Yes Yes Send SMS Yes Yes Send Yes Yes Create Contact Find Contacts Update Contact Remove Contact Yes Yes Yes Yes Yes Get Picture Yes Yes 78

79 PRODUCT DEMONSTRATION ACCESSSING THE CAMERA via the Data Control 79

80 80

81 81

82 82

83 83

84 84

85 85

86 PRODUCT DEMONSTRATION ACCESSSING THE CAMERA via a Java Bean 86

87 Get Picture API 01 public class oracle.adf.model.datacontrols.device.devicemanager { /** Provides access to the device's default camera application, which enables 04 * taking a picture or retrieving a previously-save image. 05 * 06 quality quality of save image. Range 0 to destinationtype Choose the format of the return value. 08 * - 0 base64 encoded string 1- URI to file:/// 09 sourcetype - Where should the picture come from? 10 * - 0 Library 1 Camera 2 Album 11 allowedit - Allow simple editing of image before selection 12 encodingtype - Encoding of saved imaged - 0 JPG 1 PNG 13 targetwidth - Width in pixels to scale image 14 targetheight - Height in pixels to scale image 15 - A String of either the base64 image or a file URK 16 */ 17 public String getpicture(int quality, int destinationtype, int sourcetype, 18 boolean allowedit, int encodingtype, 19 int targetwidth, int targetheight); 87

88 Get Picture API Example 01 public class MyBean { // Called via a button 04 public void actiongetpicture(actionevent event) { 05 DeviceManager device = DeviceManagerFactory.getDeviceManager(); String imagedata = 08 device.getpicture(100, 09 DeviceManager.CAMERA_DESTINATIONTYPE_FILE_URL 10 DeviceManager.CAMERA_SOURCETYPE PHOTOLIBRARY, 11 false, 12 DeviceManager.CAMERA_ENCODINGTYPE_JPEG, 13 0, 0); 14 } 88

89 Working With The Camera Pay attention to picture quality File size impacts memore/network traffic To return picture to the page: Set destinationtype to 1 (file name) Drop Return of getpicture as Output Text Drop Image component onto page Set source to return input value (#{bindings.return.inputvalue}) 89

90 Accessing Device Properties Service Data Control EL Access Programmatic Device Properties Yes Yes Send SMS Yes Yes Send Yes Yes Create Contact Find Contacts Update Contact Remove Contact Yes Yes Yes Yes Yes Get Picture Yes Yes Start Location Monitor Yes Yes 90

91 Working with Location Services Acquire the device's current position One instant in time, or on a periodic basis Uses the startlocationmonitor operation Use a geo-decoder to get address from coordinates 91

92 PRODUCT DEMONSTRATION USING THE GPS via the Data Control 92

93 93

94 94

95 95

96 PRODUCT DEMONSTRATION USING THE GPS via a Java Bean 96

97 Start Updating Position API 01 public class oracle.adf.model.datacontrols.device.devicemanager { /** Register a callback to receive updates on the device's position 04 * 05 updateinterval - how often to retrieve position(ms). 06 enablehighaccuracy receive best possible results at cost of 07 * increased power/computation expense. 08 watchid - unique handle id that can be used to 09 * subsequently stop listening for updates. 10 callback - an implementation of 11 * GeolocationCallback which can be invoked 12 * at updateinterval to deliver the 13 * device's location. 14 */ 15 public java.lang.string startupdatingposition( 16 int updateinterval, boolean enablehighaccuracy, 17 java.lang.string watchid,geolocationcallback callback) 97

98 Start Updating Position API Example 01 public class MyBean { // Called via a button 04 public void actiongetpicture(actionevent event) { 05 DeviceManager device = DeviceManagerFactory.getDeviceManager(); String watchid = device.startupdatingposition(20000, 08 true, "MyGPSSubscriptionID", 09 new GeolocationCallback() { 10 public void locationupdated(location position) { 11 System.out.println("Location updated to: " + position); 12 } 13 }); 14 device.clearwatchposition(watchid); 15 } 16 } 98

99 Summary Accessing on device features is via an API wrapping PhoneGap (Cordova) Refer to both the Oracle and 3 rd party documentation Dependent on the feature you can access it via EL expressions, the data control or Java code Some device features cannot be tested via the provided ios Simulator and Android emulator, only a real device will do 99

100 100