Overview. Android Apps (Partner s App) Other Partner s App Platform. Samsung Health. Server SDK. Samsung Health. Samsung Health Server

Transcription

1 W E L C O M E T O

2

3 Overview Android Apps (Partner s App) Data Service Health Android SDK Android API Samsung Health Samsung Health Server SDK Data REST API Oauth2 Other Partner s App Platform REST API BLE Devices (Partner s Accessories) BLE GATT Health Data Store Data Sync (Samsung Account) Samsung Health Server BLE Health Device SDK Health Data Store

4 Android SDK SDK Download App Development Apps and Services Test Apply for Partner Apps Partner App approval Samsung Health SDK Publish your Application

5 Android SDK - Data Prerequisite Android 4.4 KitKat (API level 19) or above. Download and install Health SDK Library Android smartphones including non- Samsung devices. A partner app runs with Samsung Health 4.0 or higher. Turn on Developer mode in Samsung Health App

6 Android SDK - Data Health Data Service Initialization HealthDataService healthdataservice = new HealthDataService(); try { healthdataservice.initialize(this); catch (Exception e) { e.printstacktrace(); Health Data Store Connection // Create a HealthDataStore instance and set its listener mstore = new HealthDataStore(this, mconnectionlistener); // Request the connection to the health data store mstore.connectservice(); You can end the health data store connection when the activity is destroyed. public void ondestroy() { mstore.disconnectservice(); super.ondestroy();

7 Android SDK - Data Set the listener onconnected(); onconnection Failed(); ondisconnected(); Connection Failed Handler // Create a HealthDataStore instance and set its listener mstore = new HealthDataStore(this, mconnectionlistener); private final HealthDataStore.ConnectionListener mconnectionlistener = new HealthDataStore.ConnectionListener() public void onconnected() { Log.d(APP_TAG, "Health data service is connected."); mreporter = new StepCountReporter(mStore); if (ispermissionacquired()) { mreporter.start(mstepcountobserver); else { public void onconnectionfailed(healthconnectionerrorresult error) { Log.d(APP_TAG, "Health data service is not available."); showconnectionfailuredialog(error); public void ondisconnected() { Log.d(APP_TAG, "Health data service is disconnected."); if (!isfinishing()) { mstore.connectservice();

8 Handle the connection error The connection to the health data store can fail and you can check its error result in onconnectionfailed(). If there is an error, an application checks whether the health framework provides a solution with hasresolution() and calls resolve(). If the health framework provides its solution, resolve() makes an application move to one of the following page without a dialog message: - App market s Samsung Health page to install or update it. - Device s Settings page to make Samsung Health available. - Samsung Health user s agreement page. An application needs to show a proper message for each error case and call resolve(). Android SDK - Data private void showconnectionfailuredialog(final HealthConnectionErrorResult error) { AlertDialog.Builder alert = new AlertDialog.Builder(this); if (error.hasresolution()) { switch (error.geterrorcode()) { case HealthConnectionErrorResult.PLATFORM_NOT_INSTALLED: alert.setmessage(r.string.msg_req_install); break; case HealthConnectionErrorResult.OLD_VERSION_PLATFORM: alert.setmessage(r.string.msg_req_upgrade); break; case HealthConnectionErrorResult.PLATFORM_DISABLED: alert.setmessage(r.string.msg_req_enable); break; case HealthConnectionErrorResult.USER_AGREEMENT_NEEDED: alert.setmessage(r.string.msg_req_agree); break; default: alert.setmessage(r.string.msg_req_available); break; else { alert.setmessage(r.string.msg_conn_not_available); alert.setpositivebutton(r.string.ok, (dialog, id) -> { if (error.hasresolution()) { error.resolve(mainactivity.this); ); if (error.hasresolution()) { alert.setnegativebutton(r.string.cancel, null); alert.show();

9 Android SDK - Data Check Permission Upon service connection, you may need to check if the required permission acquired from user or public void onconnected() { Log.d(APP_TAG, "Health data service is connected."); mreporter = new StepCountReporter(mStore); if (ispermissionacquired()) { mreporter.start(mstepcountobserver); else { requestpermission(); Request permission method, to be called when required permission is not acquired. private boolean ispermissionacquired() { PermissionKey permkey = new PermissionKey(HealthConstants.StepCount.HEALTH_DATA_TYPE, PermissionType.READ); HealthPermissionManager pmsmanager = new HealthPermissionManager(mStore); try { // Check whether the permissions that this application needs are acquired Map<PermissionKey, Boolean> resultmap = pmsmanager.ispermissionacquired(collections.singleton(permkey)); return resultmap.get(permkey); catch (Exception e) { Log.e(APP_TAG, "Permission request fails.", e); return false;

10 Setup Permission Set meta-data in Android manifest Android SDK - Data <application> <meta-data android:name="com.samsung.android.health.permission.read" android:value="com.samsung.health.step_count" /> </application> Build permission request method *you can use: HashSet<permissionKey>() for multiple permission request requestpermission method should be called after service connected: onconnected() only if permission is not acquired setresultlistener and Handle it. private void requestpermission() { PermissionKey permkey = new PermissionKey(HealthConstants.StepCount.HEALTH_DATA_TYPE, PermissionType.READ); HealthPermissionManager pmsmanager = new HealthPermissionManager(mStore); try { // Show user permission UI for allowing user to change options pmsmanager.requestpermissions(collections.singleton(permkey), MainActivity.this).setResultListener(result -> { Log.d(APP_TAG, "Permission callback is received."); Map<PermissionKey, Boolean> resultmap = result.getresultmap(); if (resultmap.containsvalue(boolean.false)) { updatestepcountview(""); showpermissionalarmdialog(); else { // Get the current step count and display it mreporter.start(mstepcountobserver); ); catch (Exception e) { Log.e(APP_TAG, "Permission setting fails.", e);

11 Android SDK - Data Let s everything together

12 Android SDK - Service Prerequisite Android 4.4 KitKat (API Level 19) or above. Android smartphones including non- Samsung devices. Download and install Health SDK Library *in most case you may need to load Samsung Health Data library as well Samsung Health's partner app runs with Samsung Health 4.0 or above. Turn on Developer mode in Samsung Health App

13 Android SDK - Service private static final String STORE_URL = "market://details?id=com.sec.android.app.shealth"; Health Data Service Initialization Shealth shealth = new Shealth(); try { shealth.initialize(this); Check Feature availability if (shealth.isfeatureenabled(shealth.feature_tracker_tile, Shealth.FEATURE_TRACKER_LAUNCH_EXTENDED)) { mtrackermanager = new TrackerManager(this); mtrackertilemanager = new TrackerTileManager(this); else { Log.d(LOG_TAG, "SHealth should be upgraded"); Intent intent = new Intent(Intent.ACTION_VIEW, Uri.parse(STORE_URL)); this.startactivity(intent); finish(); return; catch (IllegalStateException e) { Log.e(LOG_TAG, e.tostring()); Toast.makeText(this, e.tostring(), Toast.LENGTH_LONG).show(); finish(); return; catch (IllegalArgumentException e) { Log.e(LOG_TAG, e.tostring()); Toast.makeText(this, e.tostring(), Toast.LENGTH_LONG).show(); finish(); return;

14 Android SDK - Service Create Tracker Manager try { mtrackermanager = new TrackerManager(this); catch (IllegalArgumentException e) { Create a TrackerManager's instance first. Launching the Samsung Health's tracker is supported in Samsung Health 4.8 or above. Log.e(LOG_TAG, e.tostring()); Toast.makeText(this, e.tostring(), Toast.LENGTH_LONG).show(); finish(); return; Get Tracker Info The interesting tracker's information can be retrieved by TrackerManager. Check the tracker's availability also. TrackerInfo trackerinfo = mtrackermanager.gettrackerinfo(trackermanager.trackerid.water); if(trackerinfo == null) { Log.d(APP_TAG, "trackerinfo == null"); return null; if(trackerinfo.isavailable() == false) { Log.d(APP_TAG, "trackerinfo is not available."); return null; return trackerinfo; Retrieve Tracker Info ((ImageView)findViewById(R.id.water_icon_img)).setImageDrawable(trackerInfo.getIcon()); ((TextView)findViewById(R.id.water_service_name)).setText(trackerInfo.getDisplayName());

15 Android SDK - Service Launching available Tracker If the tracker is available, you can launch it. try { mtrackermanager.startactivity((activity)v.getcontext(), TrackerManager.TrackerId.WATER, TrackerManager.Destination.TRACK); catch (IllegalArgumentException e) { Toast.makeText(getApplicationContext(), e.tostring(), Toast.LENGTH_SHORT).show(); catch (IllegalStateException e) { Toast.makeText(getApplicationContext(), e.tostring(), Toast.LENGTH_SHORT).show();

16 Posting Your App's Tracker If you cannot find a wanted tracker on Samsung Health, you can define your app's own tracker. Manifest for Tracker Definition Android SDK - Service <?xml version="1.0" encoding="utf-8"?> <resources> <string name="sample_tracker_manifest"> { \"tracker\" : { \"id\" : \"tracker.sample\", \"display-name\" : \"tracker_display_name\", \"icon\" : \"tracker_icon\", \"controller\" : \"local.sapl.dev.shealth.service.mytracker\" </string> </resources> Plugin Service Declaration and Registration of Plugin Service Plugin service must be declared in the app s manifest from Android Oreo (API Level 26). Use your app s package name in the android authorities. <provider android:name="com.samsung.android.sdk.shealth.plugincontentprovider" android:authorities="com.samsung.android.app.sampleservice.pluginservice" android:exported="true"> </provider> <service android:name="com.samsung.android.sdk.shealth.pluginservice" android:exported="true" > <meta-data android:name="tracker.sample" android:value="@string/sample_tracker_manifest"/> </service> android:name - the tracker ID of the tracker manifest file. android:value - the resource name of the tracker manifest file.

17 Android SDK - Service Handling Event from Samsung Health Creating a TrackerTileManager's Instance Creating Tracker Tile's Intent Let s everything together Posting a Tracker Tile Updating the Posted Tracker Tile

18