このセクションでは、CatalystコンソールでのFace Analyticsの操作のみを説明します。アプリケーションのコードにFace Analyticsを実装する方法については、SDKおよびAPIドキュメントのセクションを参照してください。

前述のとおり、コンソールからCatalystアプリケーションにFace Analyticsを統合するためのコードテンプレートにアクセスでき、また顔が含まれる画像をアップロードして結果を取得することで機能をテストすることもできます。

Face Analyticsへのアクセス

CatalystコンソールでFace Analyticsにアクセスするには：

1. Catalystコンソールの左ペインでZia Servicesに移動し、Face Analyticsをクリックします。
   
   
2. Try a Demoをクリックすると、Face Analytics機能が開きます。
   

CatalystコンソールでのFace Analyticsのテスト

Catalystのサンプル画像を選択するか、独自の画像をアップロードして、Face Analyticsをテストできます。

サンプル画像をスキャンして結果を表示するには：

1. ボックス内のSelect a Sample Imageをクリックします。
   
   
2. 提供されたサンプルから画像を選択します。
   
   Face Analyticsが画像内の顔をスキャンし、属性を分析・予測し、検出された各顔について分析のテキスト結果と各predictionのconfidence scoreをパーセンテージ値で提供します。
   
   レスポンスバーの色は、predictionのconfidenceパーセンテージの範囲を示します。赤：0-30%、オレンジ：30-80%、緑：80-100%です。
   各顔の一般的な座標とローカライズされたランドマークの座標は、その他の検出結果に加えて、デフォルトでadvancedランドマークローカリゼーションモードのJSON responseで提供されます。View ResponseをクリックしてJSON responseを表示します。
   
   完全なサンプルJSON responseの構造については、APIドキュメントを参照してください。

独自の画像をアップロードしてFace Analyticsをテストするには：

1. _Result_セクションの下にあるUploadをクリックします。
   
   Face Analyticsを閉じた後に再度開く場合は、このボックス内のBrowse Filesをクリックします。
   
   
2. ローカルシステムからファイルをアップロードします。
   

コンソールが画像内の顔をスキャンし、検出された顔の4つの属性の分析を表示します。

前述のとおり、Face Analyticsは画像内で最大10個の顔を検出し、属性を分析できます。サイドの矢印をクリックして、検出された各顔の結果を確認できます。JSON responseにも検出された各顔の結果が含まれます。

Face Analyticsのコードテンプレートへのアクセス

CatalystがJava、Node.js、Pythonプラットフォーム用に提供するコードテンプレートを使用して、CatalystアプリケーションにFace Analyticsを実装できます。

テストウィンドウの下のセクションからアクセスできます。Java SDK、NodeJS SDK、またはPython SDKタブをクリックし、コピーアイコンを使用してコードをコピーします。このコードを、必要な箇所のWebまたはAndroidアプリケーションのコードに貼り付けることができます。

Javaでは、入力ファイルを新しいFileとして処理できます。ZCFaceAnalyticsOptionsモジュールにより、各属性の分析を有効または無効にするオプションが提供されます。たとえば、setAgeNeededをfalseに設定すると、Face Analyticsは画像内で検出された顔の年齢prediction結果を提供しません。また、setAnalyseModeを使用して、ランドマークローカリゼーションモードをBASIC、MODERATE、またはADVANCEDに設定できます。

Node.jsでは、facePromiseオブジェクトを使用して入力画像ファイルとそのオプション設定を保持します。modeをbasic、moderate、またはadvancedとして指定し、属性をtrueまたはfalseに設定して分析を有効または無効にできます。

Pythonでは、analyse_face()メソッドが引数として入力画像を受け取ります。分析モードをbasic、moderate、またはadvancedとして指定することもできます。また、属性age、smile、genderをtrue（検出する）またはfalse（検出しない）として指定できます。これらの値はオプションです。デフォルトでは、すべての属性が検出され、advancedモードが処理されます。