Adding Android code snippets to using-unlock-with-tap.md

Author: diegodobelo

docs/capability-guides/mobile-access/mobile-device-sdks/using-unlock-with-tap.md

@@ -37,6 +37,18 @@ let credentialsSubscription = Seam.shared.$credentials
     }
 ```
 {% endtab %}
+
+{% tab title="Android Kotlin" %}
+```kotlin
+import co.seam.core.api.SeamCredential
+import co.seam.core.api.SeamSDK
+
+// Collect credentials
+SeamSDK.getInstance().credentials.collect { credentials ->
+    // Update UI with new credentials array.
+}
+```
+{% endtab %}
 {% endtabs %}
 
 ## 2. Monitor Credential Errors
@@ -57,6 +69,38 @@ let errorSubscription = Seam.shared.$credentials
     }
 ```
 {% endtab %}
+{% tab title="Android Kotlin" %}
+```kotlin
+import co.seam.core.api.SeamCredential
+import co.seam.core.api.SeamSDK
+import co.seam.core.sdkerrors.SeamCredentialError
+import co.seam.core.sdkerrors.SeamError
+import co.seam.core.sdkerrors.SeamRequiredUserInteraction
+
+SeamSDK.getInstance().credentials.collect { credentialsList ->
+    val errors = credentialsList.flatMap { it.errors }
+    errors.forEach { error ->
+        when (error) {
+            is SeamCredentialError.Expired -> { /* handle credential expiration error */}
+            is SeamCredentialError.Loading -> { /* handle not loaded yet */ }
+            is SeamCredentialError.Unknown -> { /* handle unknown error */}
+            is SeamCredentialError.UserInteractionRequired -> {
+                handleUserInteractionRequired(error.interaction)
+            }
+        }
+    }
+}
+
+fun handleUserInteractionRequired(interaction: SeamRequiredUserInteraction) {
+    when (interaction) {
+        is SeamRequiredUserInteraction.CompleteOtpAuthorization -> { /* handle OTP authorization */ }
+        is SeamRequiredUserInteraction.EnableBluetooth -> { /* handle Bluetooth error */ }
+        is SeamRequiredUserInteraction.EnableInternet -> { /* handle Internet connection error*/ }
+        is SeamRequiredUserInteraction.GrantPermissions -> { /* handle permissions error*/ }
+    }
+}
+```
+{% endtab %}
 {% endtabs %}
 
 > **Note:** The `.errors` array on credentials represents per-credential issues, though some issues may be repeated across several credentials (for example, bluetooth requirements). SDK- or credential-level errors (such as invalid token or expired credential) are thrown directly by methods like `unlock(using:)` because `SeamError` or `SeamCredentialError` and must be handled through `do/catch`.
@@ -118,6 +162,82 @@ do {
     // Handle unlock initialization error.
     print("Unlock error: \(error)")
 }
+```
+{% endtab %}
+{% tab title="Android Kotlin" %}
+```kotlin
+import co.seam.core.api.SeamCredential
+import co.seam.core.api.SeamSDK
+import co.seam.core.events.SeamUnlockEvent
+import co.seam.core.sdkerrors.SeamCredentialError
+import co.seam.core.sdkerrors.SeamError
+import co.seam.core.sdkerrors.SeamRequiredUserInteraction
+
+val seamSDK = SeamSDK.getInstance()
+
+// Perform unlock
+try {
+    val credentialId = credential.id
+    // Timeout is optional
+    seamSDK.unlock(
+        credentialId = credentialId,
+        timeout = 30.seconds
+    )
+} catch (seamError: SeamError) {
+    when (seamError) {
+        is SeamError.ActivationRequired -> {
+            // handle error when SDK is not activated
+        }
+        is SeamError.CredentialErrors -> {
+            val credentialErrors = seamError.errors
+            handleCredentialErrors(credentialErrors)
+            // handle error when there are credential errors
+        }
+        is SeamError.InitializationRequired -> {
+            // handle error when SDK is not initialized
+        }
+        is SeamError.IntegrationNotFound -> {
+            // handle error when integration is not found, Such as Assa Abloy, Latch and Salto
+        }
+        is SeamError.InternetConnectionRequired -> {
+            // handle error when internet connection is required
+        }
+        is SeamError.InvalidClientSessionToken -> {
+            // handle error when client session token is invalid
+        }
+        else -> {
+            // handle other errors
+        }
+    }
+}
+
+// Handle credential errors on unlock
+fun handleCredentialErrors(credentialErrors: List<SeamCredentialError>) {
+    credentialErrors.forEach { credentialError ->
+        when (credentialError) {
+            is SeamCredentialError.Invalid -> {
+                // handle error when credential is invalid
+            }
+
+            is SeamCredentialError.Expired -> {
+                // handle error when credential is expired
+            }
+
+            is SeamCredentialError.Loading -> {
+                // handle error when credential is not loaded yet
+            }
+
+            is SeamCredentialError.UserInteractionRequired -> {
+                // handle user interaction required credential error
+            }
+
+            is SeamCredentialError.Unknown -> {
+                // handle unknown credential error
+            }
+        }
+    }
+}
+
 ```
 {% endtab %}
 {% endtabs %}
@@ -192,6 +312,24 @@ do {
 }
 ```
 {% endtab %}
+
+{% tab title="Android Kotlin" %}
+```kotlin
+// Start collecting unlock events before unlock
+coroutineScope.launch {
+    seamSDK.unlockStatus.collect { event ->
+        when (event) {
+            is SeamUnlockEvent.ScanningStarted -> { /* handle scanning started */}
+            is SeamUnlockEvent.Connecting -> { /* handle connecting */}
+            is SeamUnlockEvent.AccessGranted -> { /* handle access granted */}
+            is SeamUnlockEvent.Timeout -> { /* handle timeout */}
+            is SeamUnlockEvent.ReaderError -> { /* handle reader error */}
+            else -> { /* handle other events */}
+        }
+    }
+}
+```
+{% endtab %}
 {% endtabs %}
 
 ## 5. Cancel the Unlock Operation