thinkgear.net_sdk_dev_guide_and_api_reference.txt · Last modified: 2014/11/21 14:16 by Tai-Ting Tseng

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
thinkgear.net_sdk_dev_guide_and_api_reference [2014/11/21 14:15]
Tai-Ting Tseng [Proper App Design]
thinkgear.net_sdk_dev_guide_and_api_reference [2014/11/21 14:16] (current)
Tai-Ting Tseng [Proper App Design]
Line 693: Line 693:
 ====== Proper App Design ====== ====== Proper App Design ======
 <​important>​Before releasing an app for real-world use, make sure your app considers or handles the following:</​important>​ <​important>​Before releasing an app for real-world use, make sure your app considers or handles the following:</​important>​
-<​nopublish>​ +
-  * If your app's Handler receives a ''​MSG_STATE_CHANGE''​ Message with any value other than ''​STATE_CONNECTING''​ or ''​STATE_CONNECTED'',​ it should carefully handle each possible error situation with an appropriate message to the user via the app's UI.  Not handling these error cases well in the UI almost always results in an extremely poor user experience of the app.  Here are some examples: +
-    * If a ''​STATE_ERR_BT_OFF''​ Message is received, the user should be prompted to turn on their Bluetooth adapter, and then they can try again. ​  +
-    * If a ''​STATE_ERR_NO_DEVICE''​ Message is received, the user should be reminded to first pair their ThinkGear hardware device to their Android device'​s Bluetooth, according to the instructions they received with their ThinkGear hardware device. +
-    * If a ''​STATE_NOT_FOUND''​ Message is received, the user should be reminded to check that their ThinkGear hardware device is properly paired to their Android device (same as the ''​STATE_ERR_NO_DEVICE''​ case), and if so, that their ThinkGear hardware device is turned on, in range, and has enough battery or charge. +
-    * See [[#TGDevice States]] for more info. +
-</​nopublish>​+
   * Always make sure your app is handling the [[#POOR SIGNAL/​SENSOR STATUS]] Data Type.  It is output by almost all ThinkGear devices, and provides important information about whether the sensor is properly in contact with the user.  If it is indicating some sort of problem (problem == not 0), then your app should notify the user to properly wear the ThinkGear hardware device, and/or disregard any other reported data values while the [[#POOR SIGNAL/​SENSOR STATUS]] continues to indicate a problem, as appropriate for your app.   * Always make sure your app is handling the [[#POOR SIGNAL/​SENSOR STATUS]] Data Type.  It is output by almost all ThinkGear devices, and provides important information about whether the sensor is properly in contact with the user.  If it is indicating some sort of problem (problem == not 0), then your app should notify the user to properly wear the ThinkGear hardware device, and/or disregard any other reported data values while the [[#POOR SIGNAL/​SENSOR STATUS]] continues to indicate a problem, as appropriate for your app.
  

About NeuroSky

NeuroSky technologies enable the most insightful and easy-to-understand health and wellness biometrics for mobile solutions, wearable devices, and service providers. The company’s proprietary, market-leading biosensor technologies provide a foundation for analyzing biometric data in a way that’s never before been practical. NeuroSky-enabled solutions deliver unique insights into body and mind health and wellness that can motivate people to make better lifestyle choices.