facePositionChanged property
read / write
报告本地人脸检测结果。
调用 RtcEngine.enableFaceDetection 开启本地人脸检测后,你可以通过该回调实时获取以下人脸检测的信息:
- 摄像头采集的画面大小。
- 人脸在画面中的位置。
- 人脸距设备屏幕的距离。
其中,人脸距设备屏幕的距离由 SDK 通过摄像头采集的画面大小和人脸在画面中的位置拟合计算得出。
Note
- 当检测到摄像头前没有人脸时,该回调触发频率会降低,以节省设备耗能。
- 当人脸距离设备屏幕过近时,SDK 不会触发该回调。
- Android 平台上,人脸距设备屏幕的距离(
distance
)值有一定误差,请不要用它进行精确计算。
FacePositionCallback
包含如下参数:
- int
imageWidth
:摄像头采集画面的宽度 (px)。 - int
imageHeight
:摄像头采集画面的高度 (px)。 - List<FacePositionInfo>
faces
:检测到的人脸信息,详见 FacePositionInfo。 检测到几张人脸,就会报告几个FacePositionInfo
数组。数组长度可以为 0,表示没有检测到摄像头前出现人脸。
Implementation
FacePositionCallback facePositionChanged