Video Intelligence API 的臉部偵測功能會搜尋影片中的臉部，並傳回：

• 在指定要求的所有影片中，偵測到臉部的影片片段。

• 選用：定義偵測到臉孔的影片影格區域的定界框。如要啟用這項功能，請將 FaceDetectionConfig 中的 includeBoundingBoxes 欄位設為 True。

• 選用：偵測到的臉部屬性。 如要啟用屬性偵測功能，請將 FaceDetectionConfig 中的 includeAttributes 欄位設為 True。(注意：您也必須將 includeBoundingBoxes 設為 True)。另請參閱DetectedAttribute。

  可能的布林值屬性：

屬性	說明
headwear	該人物戴著帽子、鴨舌帽、圍巾等。不包括固定頭髮的小物件 (例如髮夾)。
frontal_gaze	該人員的雙眼是否直視鏡頭，而非只是雙眼可見。
eyes_visible	雙眼鞏膜 (眼白) 可見。
glasses	此人戴著眼鏡。 眼鏡可以是透明或有色。 注意：如果眼鏡不是以正確方式配戴 (例如戴在頭頂或掛在脖子上)，系統會忽略眼鏡。
mouth_open	拍攝對象張開嘴巴。
smiling	該名人士面帶微笑。

如需範例，請參閱「臉部偵測」。

Video Intelligence API Visualizer

如要查看這項功能的實際運作情形，請使用 Video Intelligence API 視覺化工具。