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

Transcription

1 1

2 Integrating Device Services with ADF Mobile 2

3 Digital Convergence Do you still personally carry around a separate one of these? 3

4 The World has Converged on Smartphones But What Makes a Smartphone "Smart"? Operating system Applications Web access QWERTY keyboard (beyond messaging) Integrated device features Operating system Applications Web access QWERTY keyboard (beyond messaging) Integrated device services 4

5 ADF Mobile Architecture Device Native Container HTML5 & JavaScript Presentation ADF Mobile AMX View ADF Controller Cordova Local HTML Java VM Business Logic ADF Model Web View Server HTML JDBC SQLite App Config Push Handler Credential Management, SSO & Access Control Configuration Server Server-Generated HTML APN/GCM Push Services SOAP & REST Services Device Services Encrypted SQLite DB Mobile Device Server 5

6 Apache Cordova ADF Mobile utilizes Cordova to access the onboard devices services Provides access to: Device Properties SMS and Contacts Camera and Photo Library Geolocation 6

7 Overview Accessing Device Services 1. Data Controls 2. Implicit EL Objects 3. Java APIs 4. JavaScript APIs 7

8 Overview Accessing Device Services 1. Data Controls 2. Implicit EL Objects 3. Java APIs 4. JavaScript 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 8

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

10 Overview Accessing Device Services 1. Data Controls 2. Implicit EL Objects 3. Java APIs 4. JavaScript 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 01 DeviceManager dm = DeviceManagerFactory.getDeviceManager(); 02 dm.send (" ", "A test SMS"); 10

11 11

12 Overview Accessing Device Services 1. Data Controls 2. Implicit EL Objects 3. Java APIs 4. JavaScript APIs For non AMX pages (local HTML or remote URL) Add JavaScript library to the page Gives direct access to services 01 adf.mf.api.send ({to: 02 cc: 03 subject: "Test ", 04 body: "Test message"}); 12

13 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 13

14 Device Properties See documentation for full list Some examples: 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() 14

15 Working with Device Features Java Code Samples 15

16 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 } 16

17 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 } 17

18 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 } 18

19 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 } 19

20 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); 20

21 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 } 21

22 Some Special Considerations 22

23 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 23

24 Working With The Camera Pay attention to picture quality File size impacts memory/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}) 24

25 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 25

26 Summary Simple device feature access Declarative Java or JavaScript API Leverage Cordova infrastructure 26

27 PRODUCT DEMONSTRATION USING Device Features 27

28 28