ApsaraVideo Live:機能

カスタムリソース URL の指定

1. queen_menu を使用する場合は、次のコードを使用します。

   // 各リソースのダウンロード アドレスを設定します。これは重要です。QueenMaterial は静的シングルトンであり、メニュー コンポーネントが初期化される前に設定する必要があります。
   // MaterialType パラメーターを設定します。有効な値：MODEL、STICKER、LUT、MAKEUP、BACKGROUND、FACE_EFFECTS。
   // materialUrl は、対応するリソース パッケージをダウンロードできる URL です。リソース パッケージを ZIP ファイルに圧縮し、ルート ディレクトリに配置する必要があります。システムは、解凍された フォルダ内のリソースを自動的にスキャンしてロードします。
   QueenMaterial.getInstance().setMaterialUrl(MaterialType materialType, String materialUrl);

2. ビジネス ニーズに合わせて次のコードを変更します。

   // 手順 1：リソースのダウンロードを処理する クラスのインスタンスを初期化します。
   QueenMaterial.getInstance().init(context);
   
   // 手順 2：各リソースのダウンロード アドレスを設定します。これは重要です。requestMaterial の前に、できれば init の直後に設定してください。
   // MaterialType パラメーターを設定します。有効な値：MODEL、STICKER、LUT、MAKEUP、BACKGROUND、FACE_EFFECTS。
   // materialUrl は、対応するリソース パッケージをダウンロードできる URL です。リソース パッケージを ZIP ファイルに圧縮し、ルート ディレクトリに配置する必要があります。システムは、解凍された フォルダ内のリソースを自動的にスキャンしてロードします。
   QueenMaterial.getInstance().setMaterialUrl(MaterialType materialType, String materialUrl);
   
   
   // 手順 3：リソース ダウンロード リスナーを設定します。ダウンロードが完了したら（onReady コールバックが発生）、リソース タイプ別にリソースを使用できます。SDK はローカル パスを連結します。
   QueenMaterial.getInstance().setCallback(new QueenMaterial.OnMaterialCallback() {
   
       @Override
       public void onReady(QueenMaterial.MaterialType materialType) {
           // リソース ダウンロード完了の コールバックは、UI 以外の スレッドで呼び出されます。ほとんどの場合、ロード ボックスが閉じられ、ビジネス ロジックがトリガーされます。
   
           // ステッカー設定を構成します。
           String stickerName = "1"; // ステッカーの相対パス。
           String stickerPath = QueenMaterial.getInstance().getMaterialPath(QueenMaterial.MaterialType.STICKER) + File.separator + stickerName;
           // QueenEngine にステッカーを追加します。
           engine.addMaterial(stickerResPath);
       }
   
       @Override
       public void onProgress(QueenMaterial.MaterialType materialType, int currentSize, int totalSize, float progress) {
           // リソース ダウンロードの進捗状況の コールバックは、UI 以外の スレッドで呼び出されます。ほとんどの場合、ダウンロードの進捗状況が更新されます。
       }
   
       @Override
       public void onError(QueenMaterial.MaterialType materialType) {
           // リソース ダウンロード エラーの コールバックは、UI 以外の スレッドで呼び出されます。ほとんどの場合、ロード ボックスが閉じられ、ネットワークとディスク容量を確認するように求める メッセージが表示されます。
       }
   
   });
   
   // 手順 4：ダウンロードをリクエストします。メニュー ウィジェットをカスタマイズする場合は、ダウンロードをリクエストする必要があります。
   QueenMaterial.getInstance().requestMaterial(MaterialType materialType);

高度なレタッチ

// 高度なレタッチを有効にするかどうかを指定します。
engine.enableBeautyType(BeautyFilterType.kFaceBuffing, true);
// 笑いジワ除去のレベルを設定します。有効な値：[0,1]。
engine.setBeautyParam(BeautyParams.kBPNasolabialFolds, 0.3f); 
// くま除去のレベルを設定します。有効な値：0～1。
engine.setBeautyParam(BeautyParams.kBPPouch, 0.3f); 
// 歯のホワイトニングのレベルを設定します。有効な値：0～1。
engine.setBeautyParam(BeautyParams.kBPWhiteTeeth, 0.2f); 
// 口紅効果のレベルを設定します。有効な値：0～1。
engine.setBeautyParam(BeautyParams.kBPLipstick, 0.2f); 
// チーク効果のレベルを設定します。有効な値：0～1。
engine.setBeautyParam(BeautyParams.kBPBlush, 0.2f);
// 目の輝きのレベルを設定します。有効な値：0～1。
engine.setBeautyParam(BeautyParams.kBPBrightenEye, 1.0f);
// バラ色の頬のレベルを設定します。有効な値：0～1。
engine.setBeautyParam(BeautyParams.kBPBlush, 1.0f);
// 口紅の色を設定します。有効な値：-0.5～0.5。色、彩度、明るさを一緒に設定する必要があります。黄土色の場合は -0.125、ピンク色の場合は -0.1、ヴィンテージ レッドの場合は 0.0、マゼンタの場合は -0.2、真紅の場合は -0.08、オレンジ レッドの場合は 0.0、紫色の場合は -0.42、オレンジ色の場合は 0.125、黄色の場合は 0.25 に設定できます。
engine.setBeautyParam(BeautyParams.kBPLipstickColorParam, 0.0f);
// 口紅の彩度を設定します。有効な値：0～1。色、彩度、明るさを一緒に設定する必要があります。黄土色の場合は 0.25、ピンク色の場合は 0.125、ヴィンテージ レッドの場合は 1.0、マゼンタの場合は 0.35、真紅の場合は 1.0、オレンジ レッドの場合は 0.35、紫色の場合は 0.35、オレンジ色の場合は 0.25、黄色の場合は 0.45 に設定できます。
engine.setBeautyParam(BeautyParams.kBPLipstickGlossParam, 0.0f);
// 口紅の明るさを設定します。有効な値：0～1。色、彩度、明るさを一緒に設定する必要があります。黄土色の場合は 0.4、ピンク色の場合は 0.0、ヴィンテージ レッドの場合は 0.2、マゼンタの場合は 0.0、真紅の場合は 0.0、オレンジ レッドの場合は 0.0、紫色の場合は 0.0、オレンジ色の場合は 0.0、黄色の場合は 0.0 に設定できます。
engine.setBeautyParam(BeautyParams.kBPLipstickBrightnessParam, 1.0f);
// しわ除去のレベルを設定します。有効な値：0～1。
engine.setBeautyParam(BeautyParams.kBPWrinkles, 0.2f);
// 肌の明るさのレベルを設定します。有効な値：0～1。
engine.setBeautyParam(BeautyParams.kBPBrightenFace, 0.2f);
// HSV カラー モデルを有効にします。
engine.enableBeautyType(BeautyFilterType.kHSV,true);
// 彩度のレベルを設定します。有効な値：[-1,1]。
engine.setBeautyParam(BeautyParams.kBPHSV_SATURATION,0.2f);
// コントラストのレベルを設定します。有効な値：[-1,1]。
engine.setBeautyParam(BeautyParams.kBPHSV_CONTRAST,0.2f);

顔効果

// モザイク効果を構成します。
engine.enableBeautyType(BeautyFilterType.kBTEffectMosaicing,true);
engine.setBeautyParam(BeautyParams.kBPEffects_Mosaicing,0.45f);

フェイス シェイピング

/**
 * フェイス シェイピングを有効にするかどうかを指定します。2 番目のパラメーターは、フェイス シェイピングを有効にするかどうかを指定します。3 番目のパラメーターは、デバッグを有効にするかどうかを指定します。
 * 4 番目のパラメーターは、フェイス シェイピング モードを指定します。有効な値：kBMFaceShape_Baseline、kBMFaceShape_Main、kBMFaceShape_High、kBMFaceShape_Max。変形レベルは順番に増加します。
 */
engine.enableBeautyType(BeautyFilterType.kFaceShape, true, false, BeautyFilterMode.kBMFaceShape_Main);
/**
 * フェイス シェイピング：頬骨
 * 有効な値：0～1。
 */
engine.updateFaceShape(FaceShapeType.typeCutCheek, 0.0f);
/**
 * フェイス シェイピング：頬骨の狭窄
 * 有効な値：0～1。
 */
engine.updateFaceShape(FaceShapeType.typeCutFace, 0.0f);
/**
 * フェイス シェイピング：小顔
 * 有効な値：0～1。
 */
engine.updateFaceShape(FaceShapeType.typeThinFace, 0.0f);
/**
 * フェイス シェイピング：顔の長さ
 * 有効な値：0～1。
 */
engine.updateFaceShape(FaceShapeType.typeLongFace, 0.0f);
/**
 * フェイス シェイピング：顎の短縮
 * 有効な値：-1～1。
 */
engine.updateFaceShape(FaceShapeType.typeLowerJaw, 0.0f);
/**
 * フェイス シェイピング：顎の延長
 * 有効な値：-1～1。
 */
engine.updateFaceShape(FaceShapeType.typeHigherJaw, 0.0f);
/**
 * フェイス シェイピング：顎の細身化
 * 有効な値：0～1。
 */
engine.updateFaceShape(FaceShapeType.typeThinJaw, 0.0f);
/**
 * フェイス シェイピング：顎のラインの細身化
 * 有効な値：0～1。
 */
engine.updateFaceShape(FaceShapeType.typeThinMandible, 0.0f);
/**
 * フェイス シェイピング：大きな目
 * 有効な値：0～1。
 */
engine.updateFaceShape(FaceShapeType.typeBigEye, 0.0f);
/**
 * フェイス シェイピング：目尻の整形 1
 * 有効な値：0～1。
 */
engine.updateFaceShape(FaceShapeType.typeEyeAngle1, 0.0f);
/**
 * フェイス シェイピング：目の距離
 * 有効な値：-1～1。
 */
engine.updateFaceShape(FaceShapeType.typeCanthus, 0.0f);
/**
 * フェイス シェイピング：目の距離の増加
 * 有効な値：-1～1。
 */
engine.updateFaceShape(FaceShapeType.typeCanthus1, 0.0f);
/**
 * フェイス シェイピング：目尻の整形 2
 * 有効な値：-1～1。
 */
engine.updateFaceShape(FaceShapeType.typeEyeAngle2, 0.0f);
/**
 * フェイス シェイピング：目の高さ
 * 有効な値：-1～1。
 */
engine.updateFaceShape(FaceShapeType.typeEyeTDAngle, 0.0f);
/**
 * フェイス シェイピング：鼻の細身化
 * 有効な値：0～1。
 */
engine.updateFaceShape(FaceShapeType.typeThinNose, 0.0f);
/**
 * フェイス シェイピング：小鼻の細身化
 * 有効な値：0～1。
 */
engine.updateFaceShape(FaceShapeType.typeNosewing, 0.0f);
/**
 * フェイス シェイピング：鼻の長さ
 * 有効な値：-1～1。
 */
engine.updateFaceShape(FaceShapeType.typeNasalHeight, 0.0f);
/**
 * フェイス シェイピング：鼻先の長さ
 * 有効な値：-1～1。
 */
engine.updateFaceShape(FaceShapeType.typeNoseTipHeight, 0.0f);
/**
 * フェイス シェイピング：唇の幅
 * 有効な値：-1～1。
 */
engine.updateFaceShape(FaceShapeType.typeMouthWidth, 0.0f);
/**
 * フェイス シェイピング：唇のサイズ
 * 有効な値：-1～1。
 */
engine.updateFaceShape(FaceShapeType.typeMouthSize, 0.0f);
/**
 * フェイス シェイピング：唇の高さ
 * 有効な値：-1～1。
 */
engine.updateFaceShape(FaceShapeType.typeMouthHigh, 0.0f);
/**
 * フェイス シェイピング：人中
 * 有効な値：-1～1。
 */
engine.updateFaceShape(FaceShapeType.typePhiltrum, 0.0f);
/**
 * フェイス シェイピング：生え際
 * 有効な値：-1～1。
 */
engine.updateFaceShape(FaceShapeType.typeHairLine, 0.0f);
/**
 * フェイス シェイピング：笑顔
 * 有効な値：-1～1。
 */
engine.updateFaceShape(FaceShapeType.typeSmile, 0.0f);

ボディ シェイピング

/**
* ボディ シェイピングを有効にするかどうかを指定します。2 番目のパラメーターは、ボディ シェイピングを有効にするかどうかを指定します。3 番目のパラメーターは、デバッグを有効にするかどうかを指定します。
*/
engine.enableBeautyType(BeautyFilterType.kBodyShape, true, false);
/**
* ボディ シェイピング：全身
* 有効な値：-1～1。
*/
engine.updateBodyShape(BodyShapeType.kFullBody, 1.0f);
/**
* ボディ シェイピング：小顔
* 有効な値：-1～1。
*/
engine.updateBodyShape(BodyShapeType.kSmallHead, 1.0f);
/**
* ボディ シェイピング：細い脚
* 有効な値：-1～1。
*/
engine.updateBodyShape(BodyShapeType.kThinLeg, 1.0f);
/**
* ボディ シェイピング：長い脚
* 有効な値：-1～1。
*/
engine.updateBodyShape(BodyShapeType.kLongLeg, 1.0f);
/**
* ボディ シェイピング：首
* 有効な値：-1～1。
*/
engine.updateBodyShape(BodyShapeType.kLongNeck, 1.0f);
/**
* ボディ シェイピング：細いウエスト
* 有効な値：-1～1。
*/
engine.updateBodyShape(BodyShapeType.kThinWaist, 1.0f);
/**
* ボディ シェイピング：バストアップ
* 有効な値：-1～1。
*/
engine.updateBodyShape(BodyShapeType.kEnhanceBreast, 1.0f);
/**
* ボディ シェイピング：腕
* 有効な値：-1～1。
*/
engine.updateBodyShape(BodyShapeType.kThinArm, 1.0f);

メイク

メイクを有効にします。

// 2 番目のパラメーターは、メイクを有効にするかどうかを指定します。3 番目のパラメーターは、デバッグを有効にするかどうかを指定します。
// 4 番目のパラメーターは、メイク モードを指定します。このパラメーターは眉毛にのみ有効です。このパラメーターを BeautyFilterMode.kBMFaceMakeup_High に設定すると、眉毛の変形レベルが高くなります。このパラメーターを BeautyFilterMode.kBMFaceMakeup_Baseline に設定すると、眉毛の変形レベルが低くなります。
engine.enableBeautyType(BeautyFilterType.kMakeup, true, false, BeautyFilterMode.kBMFaceMakeup_Baseline);

// メイク素材のパラメーターを指定します。
// 最初のパラメーターは、メイクのタイプを指定します。
// 2 番目のパラメーターは、メイク素材のパスを指定します。/makeup/peach makeup.png などの assets フォルダに対する相対パス、またはアクセス許可を持つ絶対パスを指定できます。
// 3 番目のパラメーターは、メイク素材を顔にどのように適用するかを指定します。4 番目のパラメーターは予約されています。
engine.setMakeupImage(MakeupType.kMakeupBlush,
           new String[]{""},  
           BlendType.kBlendCurve, 15);
/**
* kMakeupWhole は、フルフェイス メイク タイプを指定します。単一のメイク素材を使用して顔全体にメイクを適用できますが、顔の各パーツの詳細を調整することはできません。
* SDK バージョンが V1.4.0 以降の場合は、ミックス メイクを使用することをお勧めします。ミックス メイクを使用すると、顔の各パーツの詳細を調整できます。次のタイプのミックス メイクが提供されています。
* 1. ほろ酔いメイク：
*   アイシャドウの場合、パスは makeup/eyeshadow/naichazong.2.31.png で、透明度は 0.7 です。
*   まつげの場合、パスは makeup/eyelash/yesheng.2.31.png で、透明度は 0.5 です。
*   チークの場合、パスは makeup/blush/weixun.2.31.png で、透明度は 0.8 です。
*   アイライナーの場合、パスは makeup/eyeliner_292929/wenrou.2.31.png で、透明度は 0.5 です。
*   口紅の場合、パスは makeup/mouth_wumian/standout.2.31.png で、透明度は 0.5 です。
*   ハイライトの場合、パスは makeup/highlight/highlight.2.12.png で、透明度は 0.4 です。
* 2. そばかすメイク：
*   アイシャドウの場合、パスは makeup/eyeshadow/taohuafen.2.31.png で、透明度は 0.7 です。
*   まつげの場合、パスは makeup/eyelash/yesheng.2.31.png で、透明度は 0.5 です。
*   チークの場合、パスは makeup/blush/cool.2.31.png で、透明度は 0.8 です。
*   アイライナーの場合、パスは makeup/eyeliner_292929/guima.2.31.png で、透明度は 0.5 です。
*   口紅の場合、パスは makeup/mouth_yaochun/nanguase.2.31.png で、透明度は 0.5 です。
*   ハイライトの場合、パスは makeup/highlight/highlight.2.12.png で、透明度は 0.4 です。
* 3. 快活なメイク：
*   アイシャドウの場合、パスは makeup/eyeshadow/tianchengse.2.31.png で、透明度は 0.7 です。
*   まつげの場合、パスは makeup/eyelash/lingdong.2.31.png で、透明度は 0.5 です。
*   チークの場合、パスは makeup/blush/luori.2.31.png で、透明度は 0.8 です。
*   アイライナーの場合、パスは makeup/eyeliner_292929/qizhi.2.31.png で、透明度は 0.5 です。
*   口紅の場合、パスは makeup/mouth_yaochun/nanguase.2.31.png で、透明度は 0.5 です。
*   ハイライトの場合、パスは makeup/highlight/highlight.2.12.png で、透明度は 0.4 です。
* 4. ナイトクラブ メイク：
*   アイシャドウの場合、パスは makeup/eyeshadow/yeqiangwei.2.31.png で、透明度は 0.7 です。
*   まつげの場合、パスは makeup/eyelash/zhixing.2.31.png で、透明度は 0.5 です。
*   チークの場合、パスは makeup/blush/shaonv.2.31.png で、透明度は 0.8 です。
*   アイライナーの場合、パスは makeup/eyeliner_292929/wenrou.2.31.png で、透明度は 0.5 です。
*   口紅の場合、パスは makeup/mouth_zirun/zhenggongse.2.31.png で、透明度は 0.5 です。
*   ハイライトの場合、パスは makeup/highlight/highlight.2.12.png で、透明度は 0.4 です。
**/

// メイク素材の透明度を設定します。
// 2 番目のパラメーターは、素材の透明度を指定します。3 番目のパラメーターは予約されています。
engine.setMakeupAlpha(MakeupType.kMakeupBlush, 0.6f, 0.3f);

メイクを無効にします。

engine.setMakeupImage(MakeupType.kMakeupBlush, new String[], BlendType.kBlendNormal, 15);

涙袋効果を有効にします。

// 2 番目のパラメーターは、涙袋効果を有効にするかどうかを指定します。3 番目のパラメーターは、デバッグを有効にするかどうかを指定します。
engine.enableBeautyType(BeautyFilterType.kMakeup, true, false);

engine.setMakeupImage(MakeupType.kMakeupWocan,
                      new String[]{""},   // 涙袋効果には組み込み素材のみを使用します。
                      BlendType.kBlendCurve, 15);

engine.setMakeupAlpha(MakeupType.kMakeupWocan, 0.6f, 0.3f);

engine.setMakeupImage(MakeupType.kMakeupWocan, new String[], BlendType.kBlendCurve, 15);

ヘアカラー

engine.enableBeautyType(BeautyFilterType.kHairColor, true);
/**
 * ヘアカラーは、赤、緑、青（RGB）の値で表されます。これらは浮動小数点数です。
 * サンプル カラー：
 *   青：[0.3137f, 0.3137f, 0.6275f]
 *   紫：[0.6078f, 0.3529f, 0.6275f]
 *   スカイブルー：[0.3333f, 0.5492f, 0.5491f]
 *   黄：[0.6471f, 0.5294f, 0.3529f]
 *   緑：[0.3725f, 0.5882f, 0.3137f]
 *   茶：[0.3922f, 0.3333f, 0.3137f]
 *   赤：[0.5098f, 0.2745f, 0.2745f]
 */
engine.setHairColor(
  getQueenParam().hairRecord.colorRed,
  getQueenParam().hairRecord.colorGreen,
  getQueenParam().hairRecord.colorBlue);

フィルター

// フィルターを有効にするかどうかを指定します。
engine.enableBeautyType(BeautyFilterType.kLUT, true);
// 使用するフィルターを指定します。/lookups/lookup_1.png などの assets フォルダに対する相対パス、またはアクセス許可を持つ絶対パスを指定できます。
engine.setFilter(lutResPath); 
// フィルターのレベルを設定します。
engine.setBeautyParam(BeautyParams.kBPLUT, 1.0f); 

ステッカー

// 指定されたパスからステッカーを削除します。
engine.removeMaterial(oldStickerResPath);
// 指定されたパスにステッカーを追加します。ステッカーを追加した後は、再度追加することはできません。
// ステッカーのパスは、/sticker/baiyang などの assets フォルダに対する相対パス、またはアクセス許可を持つ絶対パスを指定できます。
engine.addMaterial(stickerResPath);

クロマキー

/**
 * クロマキーのパラメーターを指定します。
 * @param backgroundPath 置き換える背景画像のパス。値が "" の場合、クロマキーは無効になります。
 * @param blueScreenEnabled ブルー スクリーンを使用するかどうかを指定します。true の値は、ブルー スクリーンが使用されることを指定します。false の値は、グリーン スクリーンが使用されることを指定します。
 * @param threshold 有効な値：20～60。デフォルト値：30。デフォルト値を使用することをお勧めします。    
 */
engine.setGreenScreen(String backgroundPath, boolean blueScreenEnabled, float threshold);

背景の置き換え

// 背景の置き換えを有効にする前に、ビジネス要件に基づいてパフォーマンス モードを指定できます。サポートされているパフォーマンス モードには、自動モード、最高品質モード、バランス モード、最高パフォーマンス モードがあります。このパラメーターを指定しない場合、デフォルトで自動モードが使用されます。
engine.setSegmentPerformanceMode(SegmentPerformanceMode.Auto);

// 指定されたパスから背景画像を削除します。
engine.removeMaterial(oldBackgroundResPath);
// 指定されたパスに背景画像を追加します。背景画像を追加した後は、再度追加することはできません。
// 背景画像のパスは、/static/xiaomanyao などの assets フォルダに対する相対パス、またはアクセス許可を持つ絶対パスを指定できます。
engine.addMaterial(backgroundResPath);

// 背景の置き換えに加えて、背景ボケも有効にできます。
engine.enableBeautyType(BeautyFilterType.kBTBackgroundProcess, true);
// 背景ボケを有効にすると、デフォルトで背景がぼやけます。次のメソッドを使用して透明な背景を設定できます。これは、出力が前景として使用され、背景が合成される シナリオに適しています。
engine.setSegmentBackgroundProcessType(BackgroundProcessType.kBackgroundTransparent);

AR ライティング

/**
 * 最初のパラメーターは、拡張現実（AR）ライティングを有効にするかどうかを指定します。
 * 2 番目のパラメーターは、モードを指定します。値 1 はライティング モードを指定します。値 2 は描画モードを指定します。
 */
engine.setArWriting(true, getQueenParam().sArWritingRecord.mode);

インテリジェントな動的最適化

// インテリジェントな動的最適化を有効にします。
engine.enableBeautyType(BeautyFilterType.kBTAutoFilter, true);
// インテリジェントな動的最適化を無効にします。
engine.enableBeautyType(BeautyFilterType.kBTAutoFilter, false);