We use essential cookies for the website to function, as well as analytics cookies for analyzing and creating statistics of the website performance. To agree to the use of analytics cookies, click "Accept All". You can manage your preferences at any time by clicking "Cookie Settings" on the footer. More Information.

Only Essential Cookies
Accept All

Service Introduction

Capability Introduction

By detecting whether there is someone in the current camera preview and detecting the orientation of the human face (head), important information can be provided to the decision-making system of the smartphone, for example, in scenarios such as intelligent screen-on, intelligent screen-off, intelligent rotation, and image rotation control. Face orientation refers to the direction to which the central base line (pointing to the top of the head) of the human head faces on the facial plane, and includes five scenarios: upward, rightward, downward, leftward, and no direction (no person).

Face orientation recognition identifies face (head) orientation in an image, and returns the orientation information, including upward-facing, right-facing, downward-facing, left-facing, and no face, by utilizing advanced image recognition technologies. The API obtains the specific face orientation category and degree of confidence.

Use Cases

This algorithm detects face (head) orientation information in images, and can be applied to scenarios in which the app needs to determine whether there is a person in the image, as well as the person's face orientation. Example:

  • Intelligent screen-on/off: When the mobile phone is picked up, the screen does not turn on if no one is detected in the front camera view, and turns on if a face is detected. When the mobile phone is put down, the screen does not turn off if a face is still detected, and turns off if no one appears in the front camera view.
  • Intelligent rotation: When the mobile phone is rotated, the screen of the mobile phone rotates according to the actual orientation of the human head instead of gravity sensing, providing users with a better experience.
  • Image rotation control: This function can be used in photography and rotation control of photos in the album. Face orientation in an image is first detected, and then the image is rotated to a specific angle as required. For example, an image in which the human head is to the right is automatically rotated counterclockwise for 90 degrees so that the image is in position, that is, the head faces upward.

The closer the confidence score is to 1, the more reliable the recognition result. If the recognition result of a 640 x 480 image shows that the headpose is upwards, and the confidence score is 0.99972343, it means that the result is very reliable.

Service Features

  • Fast: Rapid detection can be implemented by using the neural processing unit (NPU) embedded in Huawei mobile phones.
  • Lightweight: This API greatly reduces the computing time and ROM space the algorithm model takes up, making your app more lightweight.
  • Offline: This API can be used without the Internet, and it can process all the data locally.

API Restrictions

Supported Devices

For details, see Supported Devices.

Supported Countries/Regions

For details, see Supported Countries/Regions.

Function Restrictions

Function

Restrictions

Input image size

Requirement on the image size: height/width = 3/4. Otherwise, error code 200 is returned, indicating that the input parameter is invalid.

Multi-thread calling

Multi-thread calling is supported.

Intra-process and inter-process support

Currently, the face orientation detection engine supports both intra-process and inter-process modes to suit the needs in different scenarios.

App version

This API can be called only by 64-bit apps.

Search
Enter a keyword.