JCV AR SDK Android統合ドキュメント

目次

1.統合の準備

    1.1 リソースファイルの使用
    1.2 Android Studio ランタイム環境の設定
    1.3 JNI の難読化

2.SDK のアクティベーション

    2.1 ライセンスファイルを使用したアルゴリズムライブラリの認証
    2.2 モデルファイルの使用
    2.3 スタンプファイルの使用

3.シングルおよびダブル入力モード

    3.1 シングル入力モード
    3.2 ダブル入力モード
    3.3 最適化されたシングル入力モード
    3.4 最適化されたダブル入力モード
    3.5 入力モードの切り替え

4.SDK の API の使用

    4.1 SDK ハンドルの初期化
    4.2 カメラプレビューのテクスチャとデータの取得
    4.3 カメラプレビューのテクスチャとデータの処理
    4.4 フレーム処理フロー
    4.5 SDK ハンドルの解放

5.JNI API の概要

    5.1 STMobileCommon
    5.2 STMobileHumanActionNative
    5.3 STMobileFaceAttributeNative
    5.4 STBeautifyNative
    5.5 STMobileStickerNative
    5.6 STSoundPlay
    5.7 STMobileStreamFilterNative
    5.8 STMobileFilterNative
    5.9 STMobileObjectTrackNative
    5.10 STHumanAction

6.回転と方向に関する手順

    6.1 カメラの方向
    6.2 HumanAction API の方向
※一部コードが資料の都合上途切れている部分があります。サンプルコードと同じ内容が記載されておりますので、該当のサンプルコードにてご確認お願い致します。

1 統合の準備

1.1 リソースファイルの使用

    Android Studio プロジェクトを開きます。ライセンスファイル、モデルファイル、スタンプなどのファイルを JCV AR SDK ディレクトリからプロジェクトのアセットフォルダーにコピーします。
    ライセンスファイルの名前を「SenseME.lic」に変更し、アセットフォルダーにコピーします。
    face_attribute_x.x.x.model や M_SenseME_Action_x.x.x.model を含むモデルファイルをアセットフォルダーにコピーします。
    スタンプパッケージを "2D"、"3D"、"hand_action"、"deformation"、"segment" に分類し、アセットフォルダーにサブフォルダーを作成します。スタンプを分類し、名前が同じアイコンと一緒に、それぞれサブフォルダーにコピーします。アイコンがない場合は "なし" と表示されます。分類方法はカスタマイズできます詳細はサンプルの FileUtils ファイルをご参照ください。
    アセットフォルダーに "filter_xx" という名前のフィルターカテゴリフォルダーを作成し、後で使用できるようにカスタム分類フィルターモデルを適切なフォルダーにコピーします。

1.2 Android Studio ランタイム環境の設定

    初めてサンプルプロジェクトを開くと、"NDK が見つかりません" というメッセージが表示される可能性があります。[プロジェクト] を右クリックし、[モジュール設定を開く]、[SDK の場所]、[Android NDK の場所] の順にクリックして、NDK のパスを設定します。
    サンプルの JNI の部分をプロジェクトに統合するには、build.gradle プロジェクトに JNI の部分の依存関係を追加します。
1
dependencies {
2
3
... ...
4
5
////STMobileJNI の依存関係を追加します
6
7
compile project(':STMobileJNI')
8
9
... ...
10
11
}
Copied!

1.3 JNI の難読化

    プロジェクトで STMobileJNI を引用するには、次のようにプロジェクトの proguard-rules.pro ファイルに JNI の難読化を追加します。
1
-keep class com.sensetime.stmobile.* { *;}
2
3
-keep class com.sensetime.stmobile.model.* { *;}
Copied!

2 SDK のアクティベーション

2.1 ライセンスファイルを使用したアルゴリズムライブラリの認証

    SDK は、アルゴリズムライブラリの権限をライセンスファイルと照合します。 認証された後にのみ、SDK の機能を使用できます。
    SenseME.lic ファイルをアセットフォルダーにコピーした後、統合するために、次のように STLicenseUtils ユーティリティクラスの checkLicense() 関数のみを呼び出すことができます。
    1.
    まずlicenseファイルの内容を読み込みます。
    2.
    ローカルに保存されているアクティブコードを取得します。
    3.
    利用可能なアクティベーションコードがない場合は、生成します。
    4.
    checkActiveCode* コマンドを直接実行して、アクティベーションコードが有効であるかどうか確認します。
    5.
    確認に失敗した場合は、別のアクティベーションコードを生成します。
    6.
    生成に失敗した場合は、エラーメッセージが表示されます。成功すると、新しいアクティベーションコードが保存され、成功したことを示すメッセージが表示されます。
1
private final static String PREF_ACTIVATE_CODE_FILE = "activate_code_file";
2
3
private final static String PREF_ACTIVATE_CODE = "activate_code";
4
5
private static final String LICENSE_NAME = "SenseME.lic";
6
7
/**
8
9
* 既存のアクティベーションコードが有効か確認します
10
11
* @return 成功した場合は true を、失敗した場合は false を返します
12
13
*/
14
15
public static boolean checkLicense(Context context) {
16
17
StringBuilder sb = new StringBuilder();
18
19
InputStreamReader isr = null;
20
21
BufferedReader br = null;
22
23
//ライセンスファイルの内容を確認します
24
25
try {
26
27
isr = new InputStreamReader(
28
context.getResources().getAssets().open(LICENSE_NAME)
29
);
30
31
br = new BufferedReader(isr);
32
33
String line = null;
34
35
while((line=br.readLine()) != null) {
36
37
sb.append(line).append("\n");
38
39
}
40
41
}
42
43
... ...
44
45
46
47
//ライセンスファイルが空の場合、エラーメッセージが返されます
48
49
if (sb.toString().length() == 0) {
50
51
LogUtils.e(TAG, "read license data error");
52
53
return false;
54
55
}
56
57
58
59
String licenseBuffer = sb.toString();
60
61
SharedPreferences sp = context.getApplicationContext()
62
.getSharedPreferences(
63
PREF_ACTIVATE_CODE_FILE,
64
Context.MODE_PRIVATE
65
);
66
67
68
String activateCode = sp.getString(PREF_ACTIVATE_CODE, null);
69
70
Integer error = new Integer(-1);
71
72
if (activateCode == null ||
73
(STMobileAuthentificationNative.checkActiveCodeFromBuffer(
74
context,
75
licenseBuffer,
76
licenseBuffer.length(),
77
activateCode,
78
activateCode.length()
79
) != 0)) {
80
81
activateCode = STMobileAuthentificationNative
82
.generateActiveCodeFromBuffer(
83
context,
84
licenseBuffer,
85
licenseBuffer.length()
86
);
87
88
89
90
if (activateCode != null && activateCode.length() >0) {
91
92
SharedPreferences.Editor editor = sp.edit();
93
94
editor.putString(PREF_ACTIVATE_CODE, activateCode);
95
96
editor.commit();
97
98
return true;
99
100
}
101
102
return false;
103
104
}
105
106
return true;
107
108
}
Copied!

2.2 モデルファイルの使用

    FileUtils ファイルを使用して、サンプルのモデルファイルを管理します。AssetsManager を使用してモデルファイルにアクセスできます。モデルファイルの使用方法については、サンプルをご参照ください。
1
public static final String MODEL_NAME_ACTION =
2
"M_SenseME_Action_5.5.1.model";
3
4
public static final String MODEL_NAME_FACE_ATTRIBUTE =
5
"M_SenseME_Attribute_1.0.1.model";
6
7
public static final String MODEL_NAME_EYEBALL_CENTER =
8
"M_Eyeball_Center.model";
9
10
public static final String MODEL_NAME_EYEBALL_CONTOUR =
11
"M_SenseME_Iris_1.11.1.model";
12
13
public static final String MODEL_NAME_FACE_EXTRA =
14
"M_SenseME_Face_Extra_5.6.0.model";
15
16
public static final String MODEL_NAME_BODY_FOURTEEN =
17
"M_SenseME_Body_Fourteen_1.2.0.model";
18
19
public static final String MODEL_NAME_HAND =
20
"M_SenseME_Hand_5.0.0.model";
21
22
public static final String MODEL_NAME_AVATAR_CORE =
23
"M_SenseME_Avatar_Core_1.0.0.model";
24
25
......
Copied!

2.3 スタンプファイルの使用

    制御下のスタンプファイルを SD カードにコピーし、パスを取得します。スタンプの変更時は、SDK の API にパスを割り当てます。
    FileUtils ツールクラスの copyStickerZipFiless() 関数を使用して、スタンプをコピーできます。
1
//スタンプファイルを、スタンプファイルごとに返されるパスと一緒にコピーします
2
3
public static ArrayList<String> copyStickerZipFiles(Context context) {
4
5
String files[] = null;
6
7
ArrayList<String> zipfiles = new ArrayList<String>();
8
9
10
11
try {
12
13
files = context.getAssets().list("");
14
15
} catch (IOException e) {
16
17
e.printStackTrace();
18
19
}
20
21
... ...
22
23
24
25
return zipfiles;
26
27
}
Copied!
    FileUtils ツールクラスの getStickerFiles() 関数を実行して、レンダリング用にスタンプのパスを取得します
    サブフォルダーでファイルをコピーするには、サンプルのメソッドをご参照ください。必要に応じて、メソッドをカスタマイズすることも可能です。

3 シングルおよびダブル入力モード

3.1 シングル入力モード

    シングル入力モードでは、カメラはテクスチャをコールバックすることによってのみデータを取得します。HumanAction を含む特定の API では、検知用のバッファーデータを入力する必要があります。そのため、glReadPixel() 関数を使用して、ARGB 形式でバッファーデータを取得する必要があります。
    メリット: バッファーをコールバックする必要がありません。統合およびデータ処理が簡単です。
    デメリット: glReadPixel() 関数は、ローエンドのマシンでは時間が掛かります。画像形式は ARGB です。顔検知で必要な場合は、グレースケールに変換する必要があります。

3.2 ダブル入力モード

    ダブル入力モードでは、カメラはテクスチャとデータバッファーを同時にコールバックします。
    メリット: シングル入力モードと比較すると、ダブル入力モードでは glReadPixel() を必要としません。画像形式は NV21 です。直接、グレースケース画像を取得できます。
    デメリット: データバッファーのコールバックを使用して、HumanAction を計算します。他の API で使用するために回転およびミラーリングされるため、統合が複雑になります。ARGB 形式を使用する場合は、変換する必要があります。スレッド同期問題もあります。
    注記: ダブル入力モードでは、スレッド同期問題、および mGlSurfaceView.requestRender() のタイミングに特に注意してください。

3.3 最適化されたシングル入力モード

    シングル入力最適化モードは、シングル入力モードに基づいて glReadPixel() を介してバッファーを取得します。取得したバッファーを使用して複数のスレッドでレンダリングおよび検知処理を行います。
    メリット: シングル入力モードよりフレームレートが高くなり、時間が掛かる検知処理ではパフォーマンスが大幅に向上します。
    デメリット: 統合が複雑です。スレッドの同期化により、レンダリングが 1 フレーム遅れます。

3.4 最適化されたダブル入力モード

    ダブル入力最適化モードは、ダブル入力モードに基づいてカメラのコールバックテクスチャを削除します。バッファーを使用したテクスチャのアップロードにより、テクスチャを取得し、そのバッファーを使用して複数のスレッドで検知処理を行います。
    メリット: シングルおよびダブル入力モードと比べて、フレームレートが高くなり、時間が掛かる検知処理ではパフォーマンスが大幅に向上します。
    デメリット: 統合が複雑です。テクスチャを手動でアップロードする必要があります。スレッドの同期化により、レンダリングが 1 フレーム遅れます。

3.5 入力モードの切り替え

    サンプルでは、異なる入力モードを使用できます
    異なる入力モードに切り替えるには、サンプルの CameraActivity.java ファイルをご参照ください。
1
//ダブル入力モードを使用
2
3
private CameraDisplayDoubleInput mCameraDisplay;
4
5
//シングル入力モードを使用
6
7
private CameraDisplaySingleInput mCameraDisplay;
8
9
//シングル入力モードの最適化
10
11
private CameraDisplaySingleInputMultiThread mCameraDisplay;
12
13
//ダブル入力モードの最適化
14
15
private CameraDisplayDoubleInputMultithread mCameraDisplay;
16
17
//シングル入力モードを使用
18
19
mCameraDisplay = new CameraDisplaySingleInput(
20
getApplicationContext(),
21
mSingleInputChangePreviewSizeListener,
22
glSurfaceView
23
);
24
25
//ダブル入力モードを使用
26
27
mCameraDisplay = new CameraDisplayDoubleInput(
28
getApplicationContext(),
29
mDoubleInputChangePreviewSizeListener,
30
glSurfaceView
31
);
32
33
//ダブル入力モードを使用
34
35
mCameraDisplay = new CameraDisplayDoubleInput(
36
getApplicationContext(),
37
mChangePreviewSizeListener,
38
glSurfaceView
39
);
40
41
//ダブル入力モードとマルチスレッド
42
43
mCameraDisplay = new CameraDisplayDoubleInputMultithread(
44
getApplicationContext(),
45
mChangePreviewSizeListener,
46
glSurfaceView
47
);
Copied!

4 SDK API の使用

4.1 SDK ハンドルの初期化

4.1.1 HumanAction API の初期化

    HumanAction API を初期化するには loadModel を実行しますが、この処理は時間が掛かります。そのため、非同期に初期化してください。本バージョンでは、サブモデル追加用の API が提供されています。初期化に必要なmodelのみを使用し、後でさらにサブモデルを追加すれば、初期化にかかる時間を削減できます。
1
//HumanAction ハンドルの初期化は時間が掛かります。そのため、非同期操作を推奨します。
2
3
private void initHumanAction() {
4
5
new Thread(new Runnable() {
6
7
@Override
8
9
public void run() {
10
11
synchronized (mHumanActionHandleLock) {
12
13
//モデルをアセットフォルダーからメモリに読み込み、
14
//基になる st_mobile_human_action_create_from_buffer API を
15
//使用して、ハンドルを作成します
16
17
int result = mSTHumanActionNative
18
.createInstanceFromAssetFile(
19
FileUtils.getActionModelName(),
20
mHumanActionCreateConfig,
21
mContext.getAssets()
22
);
23
24
LogUtils.i(
25
TAG,
26
"the result for createInstance for human_action is %d",
27
result
28
);
29
30
31
32
if (result == 0) {
33
34
mIsCreateHumanActionHandleSucceeded = true;
35
36
mSTHumanActionNative.setParam(
37
STHumanActionParamsType.ST_HUMAN_ACTION_PARAM_BACKGROUND_BLUR_STRENGTH,
38
0.35f
39
);
40
41
}
42
43
}
44
45
}
46
47
}).start();
48
49
}
Copied!
    初期化中に、シナリオに応じて画像またはビデオを設定するか、または必要に応じて修正します (詳細については STMobileHumanActionNative.java ファイルをご参照ください)。
1
//作成用にデフォルト設定された設定パラメーター
2
3
//マルチスレッドを実行して、速度を最大限に早め、遅れを減らします。必要に応じてデフォルトのパラメーターを変更します。
4
5
//ビデオを検知するためにマルチスレッドを実行します
6
7
public final static int ST_MOBILE_HUMAN_ACTION_DEFAULT_CONFIG_VIDEO =
8
9
ST_MOBILE_TRACKING_MULTI_THREAD|
10
11
ST_MOBILE_TRACKING_ENABLE_DEBOUNCE|
12
13
ST_MOBILE_TRACKING_ENABLE_FACE_ACTION|
14
15
ST_MOBILE_ENABLE_FACE_DETECT|
16
17
ST_MOBILE_ENABLE_HAND_DETECT|
18
19
ST_MOBILE_ENABLE_SEGMENT_DETECT|
20
21
ST_MOBILE_DETECT_MODE_VIDEO;
22
23
24
25
//デフォルト設定を使用して画像を検知します
26
27
//画像の検知にはシングルスレッドのみ使用できます
28
29
public final static int ST_MOBILE_HUMAN_ACTION_DEFAULT_CONFIG_IMAGE =
30
31
ST_MOBILE_TRACKING_SINGLE_THREAD|
32
33
ST_MOBILE_ENABLE_FACE_DETECT|
34
35
ST_MOBILE_ENABLE_SEGMENT_DETECT|
36
37
ST_MOBILE_ENABLE_HAND_DETECT|
38
39
ST_MOBILE_DETECT_MODE_IMAGE;
Copied!
    HumanAction API を使用して、モデルを動的に追加または削除し、リソースの割り当てを改善できます。非同期に呼び出すこともできます (詳細については、CameraDisplayDoubleInput.java ファイルをご参照してください)。
1
//動的にモデルを追加します
2
3
private void addSubModel(final String modelName){
4
5
synchronized (mHumanActionHandleLock) {
6
7
int result = mSTHumanActionNative.addSubModelFromAssetFile(
8
modelName,
9
mContext.getAssets()
10
);
11
12
LogUtils.i(TAG, "add sub model result: %d", result);
13
14
15
16
if(result == 0){
17
18
if(modelName.equals(FileUtils.MODEL_NAME_BODY_FOURTEEN)){
19
20
mDetectConfig |=
21
STMobileHumanActionNative.ST_MOBILE_BODY_KEYPOINTS;
22
23
mSTHumanActionNative.setParam(
24
STHumanActionParamsType.ST_HUMAN_ACTION_PARAM_BODY_LIMIT,
25
3.0f
26
);
27
28
}else if(modelName.equals(FileUtils.MODEL_NAME_FACE_EXTRA)){
29
30
mDetectConfig |=
31
STMobileHumanActionNative.ST_MOBILE_DETECT_EXTRA_FACE_POINTS;
32
33
}else if(modelName.equals(FileUtils.MODEL_NAME_EYEBALL_CONTOUR)){
34
35
mDetectConfig |= STMobileHumanActionNative.ST_MOBILE_DETECT_EYEBALL_CONTOUR |
36
37
STMobileHumanActionNative.ST_MOBILE_DETECT_EYEBALL_CENTER;
38
39
}else if(modelName.equals(FileUtils.MODEL_NAME_HAND)){
40
41
mDetectConfig |= STMobileHumanActionNative.ST_MOBILE_HAND_DETECT_FULL;
42
43
}
44
45
}
46
47
}
48
49
}
50
51
52
53
//動的にモデルを削除します
54
55
private void removeSubModel(final int config){
56
57
synchronized (mHumanActionHandleLock) {
58
59
mSTHumanActionNative.removeSubModelByConfig(config);
60
61
62
63
if(config == STMobileHumanActionNative.ST_MOBILE_ENABLE_BODY_KEYPOINTS){
64
65
mDetectConfig &= ~STMobileHumanActionNative.ST_MOBILE_BODY_KEYPOINTS;
66
67
}else if(config == STMobileHumanActionNative.ST_MOBILE_ENABLE_FACE_EXTRA_DETECT){
68
69
mDetectConfig &= ~STMobileHumanActionNative.ST_MOBILE_DETECT_EXTRA_FACE_POINTS;
70
71
}else if(config == STMobileHumanActionNative.ST_MOBILE_ENABLE_EYEBALL_CONTOUR_DETECT){
72
73
mDetectConfig &= ~(STMobileHumanActionNative.ST_MOBILE_DETECT_EYEBALL_CONTOUR |
74
75
STMobileHumanActionNative.ST_MOBILE_DETECT_EYEBALL_CENTER);
76
77
}else if(config == STMobileHumanActionNative.ST_MOBILE_ENABLE_HAND_DETECT){
78
79
mDetectConfig &= ~STMobileHumanActionNative.ST_MOBILE_HAND_DETECT_FULL;
80
81
}
82
83
}
84
85
}
Copied!

4.1.2 顔属性 API ハンドルの初期化

    顔属性 API ハンドルを初期化します。
1
//顔属性ハンドルを初期化します
2
3
private void initFaceAttribute() {
4
5
int result = mSTFaceAttributeNative.createInstanceFromAssetFile(
6
FileUtils.MODEL_NAME_FACE_ATTRIBUTE,
7
mContext.getAssets()
8
);
9
10
LogUtils.i(
11
TAG,
12
"the result for createInstance for faceAttribute is %d",
13
result
14
);
15
16
}
Copied!

4.1.3 美化 API ハンドルの初期化

    美化 API ハンドルを初期化します。
1
//美化ハンドルを初期化します
2
3
private void initBeauty() {
4
5
//美化およびプレビュー属性の幅と高さを初期化します
6
7
int result = mStBeautifyNative.createInstance(
8
mImageHeight,
9
mImageWidth
10
);
11
12
LogUtils.i(TAG, "the result is for initBeautify " + result);
13
14
... ...
15
16
}
Copied!

4.1.4 スタンプ API ハンドルの初期化

    スタンプ API ハンドルを初期化します。
1
//スタンプハンドルを初期化します
2
3
private void initSticker() {
4
5
iint result = mStStickerNative.createInstance(mContext, null);
6
7
8
9
if(mNeedSticker){
10
11
mStStickerNative.changeSticker(mCurrentSticker);
12
13
}
14
15
16
17
setHumanActionDetectConfig(
18
mNeedBeautify|mNeedFaceAttribute,
19
mStStickerNative.getTriggerAction()
20
);
21
22
LogUtils.i(
23
TAG, "the result for createInstance for sticker is %d",
24
result
25
);
26
27
}
Copied!

4.1.5 フィルター API ハンドルの初期化

    フィルター API ハンドルを初期化します。
1
//フィルターハンドルを初期化します
2
3
private void initFilter(){
4
5
mSTMobileStreamFilterNative.createInstance();
6
7
LogUtils.i(TAG, "filter create instance result %d", result);
8
9
10
11
mSTMobileStreamFilterNative.setStyle(mCurrentFilterStyle);
12
13
14
15
mCurrentFilterStrength = mFilterStrength;
16
17
//フィルターの強度を設定します。デフォルト値は 0.5f です。
18
19
mSTMobileStreamFilterNative.setParam(
20
STFilterParamsType.ST_FILTER_STRENGTH,
21
mCurrentFilterStrength
22
);
23
24
}
Copied!

4.1.6 一般的なオブジェクトのトラッキング API ハンドルの初期化

    一般的なオブジェクトのトラッキング API ハンドルを初期化します。
1
//一般的なオブジェクトのトラッキングハンドルの初期化
2
3
private void initObjectTrack(){
4
5
int result = mSTMobileObjectTrackNative.createInstance();
6
7
}
Copied!

4.2 カメラプレビューのテクスチャとデータの取得

    AndroidManifest.xml ファイルを追加して、システムカメラの権限を有効にします。
1
<uses-permission android:name="android.permission.CAMERA" />
Copied!
    ダブル入力モードでは、2 つのコールバックメソッド (バッファーとテクスチャ) を使用するように Android カメラを設定します。シングル入力モードでは、テクスチャをコールバックするように設定します。
1
public void startPreview(
2
SurfaceTexture surfaceTexture,
3
PreviewCallback previewcallback
4
){
5
6
try {
7
8
//テクスチャをコールバックするように設定します
9
10
mCamera.setPreviewTexture(surfaceTexture);
11
12
if (previewcallback != null) {
13
14
//バッファーをコールバックするように設定します
15
16
mCamera.setPreviewCallback(previewcallback);
17
18
}
19
20
mCamera.startPreview();
21
22
} catch (IOException e) {
23
24
e.printStackTrace();
25
26
}
27
28
}
Copied!
    Android カメラからテクスチャを取得します (詳細については、サンプルの CameraDisplayDoubleInput.java ファイル、および CameraProxy.java ファイルをご参照ください)。
1
private void setUpCamera(){
2
3
//カメラのプレビューで必要な表示領域を初期化します (mSurfaceTexture)
4
5
if(mTextureId == OpenGLUtils.NO_TEXTURE){
6
7
mTextureId = OpenGLUtils.getExternalOESTextureID();
8
9
mSurfaceTexture = new SurfaceTexture(mTextureId);
10
11
}
12
13
... ...
14
15
//mSurfaceTexture にコールバック用のカメラを追加します (テクスチャとバッファー)
16
17
mCameraProxy.startPreview(mSurfaceTexture,mPreviewCallback);
18
19
}
Copied!
    Android カメラからバッファーを取得します (詳細については、サンプルの CameraDisplayDoubleInput.java ファイル、および CameraProxy.java ファイルをご参照ください)。
1
private Camera.PreviewCallback mPreviewCallback = new Camera.PreviewCallback() {
2
3
@Override
4
5
public void onPreviewFrame(final byte[] data, Camera camera) {
6
7
8
9
if (mCameraChanging || mCameraProxy.getCamera() == null) {
10
11
return ;
12
13
}
14
15
... ...
16
17
//テクスチャを更新します
18
19
mGlSurfaceView.requestRender();
20
21
}
22
23
};
Copied!

4.3 カメラプレビューのテクスチャとデータの処理

4.3.1 テクスチャの前処理 (シングル入力モードとダブル入力モードで同様の手順)

    カメラコールバックテクスチャは水平で、通常は OES 形式です。これを GL_TEXTURE_2D 形式に変換し、回転とミラーリングを適用して、携帯電話の画面上でプレビュー画像が直立するようにします (つまり、システムのフロントカメラで撮った写真と同じ結果)。
    容易に統合また利用できるように、デモではテクスチャ前処理クラス GLRender の preProcess() 関数を提供して、効率性を向上します。カメラのコールバックバッファーを使用して HumanAction を検知する際は、preProcess() 関数で readPixel コマンドを実行しないでください。 preProcess() 関数の 2 番目のパラメーターを NULL に設定してください。
1
//テクスチャの前処理
2
3
int textureId = mGLRender.preProcess(mTextureId, null);
Copied!
    カメラからテクスチャを取得するには、デモで GLRender クラスの preProcess() 関数の使用に関する概要をご参照ください。入力テクスチャを処理した場合は、preProcess() 関数を呼び出さないでください。
    前処理済みのテクスチャは、美化、スタンプ、およびフィルター API で使用できます。

4.3.2 データ処理

    ダブル入力モードでは、カメラのコールバックバッファーデータを使用して HumanActionDetect プロセスを実行して、HumanAction 結果を取得します。テクスチャが回転およびミラーリングされているため、バッファー内のデータは処理されていません。 HumanAction の方向とテクスチャは一致しないため、後で API で使用できるよう、HumanAction の回転およびミラーリング機能を使用して、データを処理し、HumanAction の方向とテクスチャの方向を合わせます。
1
//カメラ ID とカメラの方向を使用して、HumanAction を再計算します (ダブル入力モード用)
2
3
public static STHumanAction humanActionRotateAndMirror(
4
STHumanAction humanAction,
5
int width,
6
int height,
7
int cameraId,
8
int cameraOrientation
9
){
10
11
if(humanAction == null){
12
13
return null;
14
15
}
16
17
if(cameraId != Camera.CameraInfo.CAMERA_FACING_FRONT &&
18
cameraId != Camera.CameraInfo.CAMERA_FACING_BACK){
19
20
return humanAction;
21
22
}
23
24
if(cameraOrientation != 90 && cameraOrientation != 270){
25
26
return humanAction;
27
28
}
29
30
//humanAction の回転およびミラーリング
31
32
if(cameraId == Camera.CameraInfo.CAMERA_FACING_FRONT &&
33
cameraOrientation == 90){
34
35
humanAction = humanActionRotate(
36
height,
37
width,
38
STRotateType.ST_CLOCKWISE_ROTATE_90,
39
false,
40
humanAction
41
);
42
43
humanAction = humanActionMirror(width, humanAction);
44
45
}else if(cameraId == Camera.CameraInfo.CAMERA_FACING_FRONT &&
46
cameraOrientation == 270){
47
48
humanAction = humanActionRotate(
49
height,
50
width,
51
STRotateType.ST_CLOCKWISE_ROTATE_270,
52
false,
53
humanAction
54
);
55
56
humanAction = humanActionMirror(width, humanAction);
57
58
}else if(cameraId == Camera.CameraInfo.CAMERA_FACING_BACK &&
59
cameraOrientation == 270){
60
61
humanAction = humanActionRotate(
62
height,
63
width,
64
STRotateType.ST_CLOCKWISE_ROTATE_270,
65
false,
66
humanAction
67
);
68
69
}else if(cameraId == Camera.CameraInfo.CAMERA_FACING_BACK &&
70
cameraOrientation == 90){
71
72
humanAction = humanActionRotate(
73
height,
74
width,
75
STRotateType.ST_CLOCKWISE_ROTATE_90,
76
false,
77
humanAction
78
);
79
80
}
81
82
83
84
return humanAction;
85
86
}
Copied!
    シングル入力モードでは、処理済みテクスチャを使用して、glReadPixel コマンドでバッファーデータを取得します。バッファーを使用して、HumanAction API から結果を計算します。方向はテクスチャの方向と同じであり、データを回転およびミラーリングする必要はありません。

4.4 フレーム処理フロー

注記: 本セクションで説明する美化、スタンプ、フィルター API には、OpenGL 環境が必要です。OpenGL スレッドで実行する必要があります。
    HumanAction API の使用
1
//顔特徴点、顔の動き、ジェスチャ、前景と背景のセグメンテーションを検知します
2
3
STHumanAction humanAction = mSTHumanActionNative.humanActionDetect(
4
mRGBABuffer.array(),
5
STCommon.ST_PIX_FMT_RGBA8888,
6
mDetectConfig,
7
orientation,
8
mImageWidth,
9
mImageHeight
10
);
Copied!

4.4.1 HumanAction API の使用

    HumanActionDetect 設定は、デフォルトではすべてを検知します。必要に応じて設定をカスタマイズできます。たとえば、前景と背景をセグメント化するには、"|" で結合した ST_MOBILE_SEG_BACKGROUND を追加します。ジェスチャを検知するには、適切な設定を追加してください。
1
//HumanAction のデフォルト設定
2
3
//すべてを検知するのは、時間が掛かり、CPU 使用率が高くなるため、推奨されません。
4
//必要な動作を検知するようにしてください。
5
6
public final static long ST_MOBILE_HUMAN_ACTION_DEFAULT_CONFIG_DETECT =
7
8
ST_MOBILE_FACE_DETECT | ST_MOBILE_EYE_BLINK |
9
10
ST_MOBILE_MOUTH_AH | ST_MOBILE_HEAD_YAW |
11
12
ST_MOBILE_HEAD_PITCH | ST_MOBILE_BROW_JUMP |
13
14
ST_MOBILE_HAND_GOOD | ST_MOBILE_HAND_PALM |
15
16
ST_MOBILE_HAND_LOVE | ST_MOBILE_HAND_HOLDUP |
17
18
ST_MOBILE_HAND_CONGRATULATE | ST_MOBILE_HAND_FINGER_HEART |
19
20
ST_MOBILE_DETECT_EYEBALL_CENTER|ST_MOBILE_DETECT_EYEBALL_CONTOUR;
21
22
23
24
//サポートされた顔検知設定
25
26
public final static long ST_MOBILE_FACE_DETECT = 0x00000001; //////<顔検知
27
28
29
30
//顔の動作
31
32
public final static long ST_MOBILE_EYE_BLINK = 0x00000002; ///<まばたきする
33
34
public final static long ST_MOBILE_MOUTH_AH = 0x00000004; ///口を大きく開く
35
36
public final static long ST_MOBILE_HEAD_YAW = 0x00000008; //////<頭を振る
37
38
public final static long ST_MOBILE_HEAD_PITCH = 0x00000010; ///<うなずく
39
40
public final static long ST_MOBILE_BROW_JUMP = 0x00000020; ///<眉を上げる
41
42
43
44
//ジェスチャ
45
46
public final static long ST_MOBILE_HAND_GOOD = 0x00000800; ///<親指を立てる 2048
47
48
public final static long ST_MOBILE_HAND_PALM = 0x00001000; ///<手のひら 4096
49
50
public final static long ST_MOBILE_HAND_LOVE = 0x00004000; ///<ハートのジェスチャ (16384)
51
52
public final static long ST_MOBILE_HAND_HOLDUP = 0x00008000; ///<手のひらを上に向ける 32768
53
54
public final static long ST_MOBILE_HAND_CONGRATULATE = 0x00020000; ///< お祝い (拳を握る) 131072
55
56
public final static long ST_MOBILE_HAND_FINGER_HEART = 0x00040000; //////< 片手でハートを作るジェスチャ (262144)
57
58
public final static long ST_MOBILE_HAND_TWO_INDEX_FINGER = 0x00080000;///< 並べた指 (524288)
59
60
public final static long ST_MOBILE_HAND_OK = 0x00000200; ///<OK のジェスチャ
61
62
public final static long ST_MOBILE_HAND_SCISSOR = 0x00000400; ///<勝利のポーズ
63
64
public final static long ST_MOBILE_HAND_PISTOL = 0x00002000; ///<ピストルのジェスチャ
65
66
public final static long ST_MOBILE_HAND_FINGER_INDEX = 0x00100000; ///<人差し指で指す
67
68
69
70
public final static long ST_MOBILE_HAND_FIST = 0x00200000; ///<拳のジェスチャ
71
72
public final static long ST_MOBILE_HAND_666 = 0x00400000; ///<ラッキー
73
74
public final static long ST_MOBILE_HAND_BLESS = 0x00800000; //////<禅のポーズ
75
76
public final static long ST_MOBILE_HAND_ILOVEYOU = 0x010000000000L; ///"愛している" のジェスチャ
77
78
public final static long ST_MOBILE_BODY_KEYPOINTS = 0x08000000; ///< 体の特徴点を検知
79
80
public final static long ST_MOBILE_SEG_BACKGROUND = 0x00010000; //////<前景と背景のセグメンテーション (65536)
81
82
public final static long ST_MOBILE_DETECT_EXTRA_FACE_POINTS = 0x01000000; ///< 240 の顔特徴点を検知
83
84
public final static long ST_MOBILE_DETECT_EYEBALL_CENTER = 0x02000000; ///< 眼球の中央点
85
86
public final static long ST_MOBILE_DETECT_EYEBALL_CONTOUR = 0x04000000; ///< 眼球の輪郭点
87
88
public final static long ST_MOBILE_BODY_ACTION1 = (long)1 << 32; ///龍拳
89
90
public final static long ST_MOBILE_BODY_ACTION2 = (long)1 << 33; ///一休さんのジェスチャ
91
92
public final static long ST_MOBILE_BODY_ACTION3 = (long)1 << 34; ///お手上げ
93
94
public final static long ST_MOBILE_BODY_ACTION4 = (long)1 << 35; ///スパイダーマン
95
96
public final static long ST_MOBILE_BODY_ACTION5 = (long)1 << 36; ///スーパーマン
97
98
99
100
//HumanAction 検知タイプの設定オプションを作成します
101
102
///サポートされている検知タイプ
103
104
public final static int ST_MOBILE_ENABLE_FACE_DETECT = 0x00000040; ///< 顔を検知
105
106
public final static int ST_MOBILE_ENABLE_HAND_DETECT = 0x00000080; ///< ジェスチャを検知
107
108
public final static int ST_MOBILE_ENABLE_SEGMENT_DETECT = 0x00000100; ///< 背景のセグメンテーションを検知
109
110
public final static int ST_MOBILE_ENABLE_FACE_EXTRA_DETECT = 0x00000200; ///< 240 の顔特徴点を検知
111
112
public final static int ST_MOBILE_ENABLE_EYEBALL_CENTER_DETECT = 0x00000400; ///< 眼球の中心点を検知
113
114
public final static int ST_MOBILE_ENABLE_EYEBALL_CONTOUR_DETECT = 0x00000800; ///< 眼球の輪郭を検知
115
116
public final static int ST_MOBILE_ENABLE_BODY_KEYPOINTS = 0x00001000; ///< 体の特徴点と動作を検知
117
118
public final static int ST_MOBILE_FACE_DETECT_FULL = 0x0000003F; ///< すべての顔の動きを検知
119
120
public final static int ST_MOBILE_HAND_DETECT_FULL = 0x001EFF00; ///< すべてのジェスチャを検知
121
122
///検知モード
123
124
public final static int ST_MOBILE_DETECT_MODE_VIDEO = 0x00020000; ///< ビデオの検知
125
126
public final static int ST_MOBILE_DETECT_MODE_IMAGE = 0x00040000; ///< 画像の検知
Copied!
    HumanActionDetect API を以下のように使用します。
1
STHumanAction humanAction = mSTHumanActionNative.humanActionDetect(
2
mNv21ImageData,
3
STCommon.ST_PIX_FMT_NV21,
4
mDetectConfig,
5
getHumanActionOrientation(),
6
mImageHeight,
7
mImageWidth
8
);
Copied!
    顔の表情に関しては、STMobileHumanActionNative API の STMobileExpression コマンドをご参照ください。検知 API は、HumanAction API の結果から入力を受け取り、表情をそれぞれ出力します。以下に示します。
1
if