updating Android docs

Author: kevin-spren

docs/Spren-Vision/Spren-Vision-Android-SDK.md

@@ -47,7 +47,7 @@ The open source code is available in the [Spren Vision Android SDK GitHub Reposi
 
 ## Spren UI
 
-### Implementation Example
+### Finger Camera Example
 
 ```kotlin
 // MainActivity.kt
@@ -57,6 +57,7 @@ import com.spren.sprenui.SprenUI
 class MainActivity : AppCompatActivity() {
 
     private lateinit var binding: ActivityMainBinding
+    private lateinit var hardwareAlert: HardwareAlert
 
     override fun onCreate(savedInstanceState: Bundle?) {
         super.onCreate(savedInstanceState)
@@ -69,6 +70,12 @@ class MainActivity : AppCompatActivity() {
         binding = ActivityMainBinding.inflate(layoutInflater)
         setContentView(binding.root)
 
+        // optionally check if hardware is compatible
+        hardwareAlert = HardwareAlert(this)
+        if (!HardwareCheck.isHighPerformingDevice(this)) {
+            hardwareAlert.show()
+        }
+
         // set user ID
         SprenUI.Config.userId = ...
 
@@ -97,10 +104,90 @@ class MainActivity : AppCompatActivity() {
         SprenUI.Config.onCancel = {
           // handle user exit of UI flow without completing a reading
         }
+
+        // optionally override default intro screen graphics
+        // provide drawable ids for image sets in project
+        // *all are required for each project if overriding
+        SprenUI.Config.graphics = mapOf(
+            SprenUI.Graphic.GREETING_1 to <image set drawable id>, // greeting screen 1
+            SprenUI.Graphic.GREETING_2 to <image set drawable id>, // greeting screen 2
+            SprenUI.Graphic.FINGER_ON_CAMERA to <image set drawable id>, // finger on camera instruction screen
+            SprenUI.Graphic.NO_CAMERA to <image set drawable id>, // camera access authorization denied screen
+            SprenUI.Graphic.SERVER_ERROR to <image set drawable id>  // server or calculation error
+        )
     }
 }
 ```
 
+### Body Composition Example
+
+```kotlin
+// MainActivity.kt
+
+import com.spren.sprenui.SprenUI
+
+class MainActivity : AppCompatActivity() {
+
+    private lateinit var binding: ActivityMainBinding
+    private lateinit var hardwareAlert: HardwareAlert
+
+    override fun onCreate(savedInstanceState: Bundle?) {
+        super.onCreate(savedInstanceState)
+
+        // optionally set custom theme
+        // theme inherits from "Theme.MaterialComponents.DayNight.NoActionBar"
+        // see themes.xml example below
+        setTheme(R.style.Theme_SprenUI)
+
+        binding = ActivityMainBinding.inflate(layoutInflater)
+        setContentView(binding.root)
+
+        // optionally check if hardware is compatible
+        hardwareAlert = HardwareAlert(this)
+        if (!HardwareCheck.isHighPerformingDevice(this)) {
+            hardwareAlert.show()
+        }
+
+        // set user ID
+        SprenUI.Config.userId = ...
+
+        // optionally set user biological sex
+        SprenUI.Config.userGender = ...
+
+        // optionally set user birthdate
+        SprenUI.Config.userBirthdate = ...
+
+        // after dismissing results screen
+        SprenUI.Config.onFinish =
+            { results ->
+                // user completed a scan!
+                print(results)
+                // dismiss SprenUI
+            }
+
+
+        SprenUI.Config.onCancel = {
+          // handle user exit of UI flow without completing a scan
+        }
+
+        // optionally override default intro screen graphics
+        // provide drawable ids for image sets in project
+        // *all are required for each project if overriding
+        SprenUI.Config.graphics = mapOf(
+            SprenUI.Graphic.GREETINGS to <image set drawable id>,
+            SprenUI.Graphic.PRIVACY to <image set drawable id>,
+            SprenUI.Graphic.CAMERA_ACCESS_DENIED <image set drawable id>,
+            SprenUI.Graphic.PHOTOS_ACCESS_DENIED to <image set drawable id>,
+            SprenUI.Graphic.SETUP_GUIDE to <image set drawable id>,
+            SprenUI.Graphic.SERVER_ERROR to <image set drawable id>,
+            SprenUI.Graphic.INCORRECT_BODY_POSITION to <image set drawable id>
+        )
+    }
+}
+```
+
+### Layout and Theme
+
 ```xml
 <!-- activity_main.xml corresponding to MainActivity.kt -->
 
@@ -112,6 +199,7 @@ class MainActivity : AppCompatActivity() {
     android:layout_height="match_parent"
     app:api_key="@string/api_key"
     app:base_url="@string/base_url"
+    app:project="FINGER_CAMERA" or "BODY_COMPOSITION"
     tools:context=".MainActivity" />
 ```