From c8a499041ad2305e8614d608a2e3a24b840c4eea Mon Sep 17 00:00:00 2001
From: zhounie <2676178337@qq.com>
Date: Wed, 24 Dec 2025 10:53:58 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20react-native-touch-id=E6=94=AF=E6=8C=81?=
 =?UTF-8?q?useFaceID=E4=BA=BA=E8=84=B8=E6=A0=A1=E9=AA=8C?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Signed-off-by: zhounie <2676178337@qq.com>
---
 en/react-native-touch-id.md    | 21 +++++++++++++++++++++
 zh-cn/react-native-touch-id.md | 21 +++++++++++++++++++++
 2 files changed, 42 insertions(+)

diff --git a/en/react-native-touch-id.md b/en/react-native-touch-id.md
index 869327511..b1549cef1 100644
--- a/en/react-native-touch-id.md
+++ b/en/react-native-touch-id.md
@@ -83,6 +83,24 @@ const App = () => {
           })
         }}
       ></Button>
+      <Button title='check whether you have faceID permission'
+        onPress={() => {
+          TouchID.isSupported({ unifiedErrors: false, useFaceID: true }).then((res: any) => {
+              setResult(res);
+            }).catch((err: any) => {
+              setResult(err.message);
+            });
+        }}
+      ></Button>
+      <Button title='check faceID'
+        onPress={() => {
+          TouchID.authenticate(undefined, { useFaceID: true }).then((res: boolean) => {
+            setResult('Authentication successful')
+          }).catch((err: any) => {
+            setResult(err.message)
+          })
+        }}
+      ></Button>
     </View>
   )
 };
@@ -304,6 +322,7 @@ In your `module.json5`
  	| Name | Description | Type | Required | Platform | HarmonyOS Support  |
 	| ---- | ----------- | ---- | -------- | -------- | ------------------ |
     | unifiedErrors| Returns unified error messages | boolean | no | ios/android      | yes |
+    | useFaceID | Whether to use faceID. Default is false, fingerprint will be used. If set to true, faceID will be used. | boolean | no | no      | yes |
 ## Properties
 
 > [!TIP] The **Platform** column indicates the platform where the properties are supported in the original third-party library.
@@ -335,6 +354,8 @@ In your `module.json5`
 
 ## Others
 
+- ios/android does not support the `useFaceID` parameter, which is only applicable to the HarmonyOS platform and is used to control whether the facial recognition feature is enabled.
+
 ## License
 
 This project is licensed under [The MIT License (MIT)](https://github.com/naoufal/react-native-touch-id?tab=readme-ov-file#license).
diff --git a/zh-cn/react-native-touch-id.md b/zh-cn/react-native-touch-id.md
index 9574db1e5..33617d8ee 100644
--- a/zh-cn/react-native-touch-id.md
+++ b/zh-cn/react-native-touch-id.md
@@ -81,6 +81,24 @@ const App = () => {
           })
         }}
       ></Button>
+      <Button title='验证是否有人脸权限'
+        onPress={() => {
+          TouchID.isSupported({ unifiedErrors: false, useFaceID: true }).then((res: any) => {
+              setResult(res);
+            }).catch((err: any) => {
+              setResult(err.message);
+            });
+        }}
+      ></Button>
+      <Button title='校验人脸'
+        onPress={() => {
+          TouchID.authenticate(undefined, { useFaceID: true }).then((res: boolean) => {
+            setResult('认证成功')
+          }).catch((err: any) => {
+            setResult(err.message)
+          })
+        }}
+      ></Button>
     </View>
   )
 };
@@ -305,6 +323,7 @@ In your `module.json5`
  	| Name | Description | Type | Required | Platform | HarmonyOS Support  |
 	| ---- | ----------- | ---- | -------- | -------- | ------------------ |
     | unifiedErrors| 返回统一的错误信息 |boolean| no | ios/andriod      | yes |
+    | useFaceID | 是否使用人脸识别。默认设置为false，表示使用指纹识别，如果设置为true，表示使用人脸识别。 |boolean| no | no      | yes |
 ## 属性
 
 > [!TIP] "Platform"列表示该属性在原三方库上支持的平台。
@@ -336,6 +355,8 @@ In your `module.json5`
 
 ## 其他
 
+- ios/android不支持`useFaceID`参数，该参数仅用于鸿蒙平台，用于控制是否使用人脸识别功能。
+
 ## 开源协议
 
 本项目基于 [The MIT License (MIT)](https://github.com/naoufal/react-native-touch-id?tab=readme-ov-file#license) ，请自由地享受和参与开源。
-- 
Gitee