From e9e4bb528c1fdb6c4538e8b72c70cbce488ca39b Mon Sep 17 00:00:00 2001
From: Abdullah <89297042+AzazelSensei@users.noreply.github.com>
Date: Sat, 5 Sep 2026 07:21:59 +0000
Subject: [PATCH] docs: clarify fingerPrint id is enrolled emulator id

The javadoc said fingerprint ids are 1-10. That is the emulator UI
label, not the integer adb emu finger touch uses after enrollment.

Fixes #845
---
 .../appium/java_client/android/AndroidMobileCommandHelper.java | 3 ++-
 .../io/appium/java_client/android/AuthenticatesByFinger.java   | 3 ++-
 2 files changed, 4 insertions(+), 2 deletions(-)

diff --git a/src/main/java/io/appium/java_client/android/AndroidMobileCommandHelper.java b/src/main/java/io/appium/java_client/android/AndroidMobileCommandHelper.java
index cacc04137..6541c2c7e 100644
--- a/src/main/java/io/appium/java_client/android/AndroidMobileCommandHelper.java
+++ b/src/main/java/io/appium/java_client/android/AndroidMobileCommandHelper.java
@@ -141,7 +141,8 @@ public class AndroidMobileCommandHelper extends MobileCommand {
     /**
      * This method forms a {@link Map} of parameters for the finger print authentication invocation.
      *
-     * @param fingerPrintId finger prints stored in Android Keystore system (from 1 to 10)
+     * @param fingerPrintId enrolled virtual fingerprint id passed to
+     *                      {@code adb emu finger touch}, not the emulator UI Finger 1-10 labels
      * @return a key-value pair. The key is the command name. The value is a {@link Map} command arguments.
      */
     @Deprecated
diff --git a/src/main/java/io/appium/java_client/android/AuthenticatesByFinger.java b/src/main/java/io/appium/java_client/android/AuthenticatesByFinger.java
index 611fb30ed..f5461253e 100644
--- a/src/main/java/io/appium/java_client/android/AuthenticatesByFinger.java
+++ b/src/main/java/io/appium/java_client/android/AuthenticatesByFinger.java
@@ -14,7 +14,8 @@ public interface AuthenticatesByFinger extends ExecutesMethod, CanRememberExtens
     /**
      * Authenticate users by using their finger print scans on supported emulators.
      *
-     * @param fingerPrintId finger prints stored in Android Keystore system (from 1 to 10)
+     * @param fingerPrintId enrolled virtual fingerprint id passed to
+     *                      {@code adb emu finger touch}, not the emulator UI Finger 1-10 labels
      */
     default void fingerPrint(int fingerPrintId) {
         final String extName = "mobile: fingerprint";