facePositionChanged property

FacePositionCallback facePositionChanged
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