🎯 導入の背景
iOSアプリでリアルタイムビデオ通話を行う際、ユーザーから「自然な美顔機能を付けてほしい」という要望が多くありました。
以下の条件でSDKを検討しました：
- 通話中にリアルタイムで美顔・美白・顔補正が可能
- 他SDKと同時に利用できる（TRTC通話機能との統合）
- iOSネイティブアプリに短期間で導入できる
🔍 技術調査と選定理由
| 項目 | TRTC Beauty SDKの特徴 |
|---|---|
| 機能 | 美肌、ホワイトニング、赤み、顔細見、目拡大など |
| パフォーマンス | iPhone 11以上で60fpsに近い処理可能 |
| UI | 組み込みの美顔パネル（TRTCBeautyViewController） |
| 柔軟性 | プログラムからパラメータを個別に設定できる |
| サポート | 日本語サポートは限定的だが英語/中国語は充実 |
📦 プロジェクトセットアップ
1. PodfileにTRTC SDKを追加
pod 'TXLiteAVSDK_TRTC'
インストール後:
pod install
2. Info.plist権限
<key>NSCameraUsageDescription</key>
<string>ビデオ通話のためカメラを使用します</string>
<key>NSMicrophoneUsageDescription</key>
<string>音声通話のためマイクを使用します</string>
🚀 実装ステップ
1. TRTCCloudの初期化と通話開始
#import <TXLiteAVSDK_TRTC/TRTCCloud.h>
TRTCCloud *trtcCloud = [TRTCCloud sharedInstance];
TRTCParams *params = [[TRTCParams alloc] init];
params.sdkAppId = 1400000000;
params.userId = @"user001";
params.userSig = @"xxxxxx";
params.roomId = 1234;
params.role = TRTCRoleAnchor;
[trtcCloud enterRoom:params appScene:TRTCAppSceneVideoCall];
[trtcCloud startLocalPreview:YES view:self.localView];
[trtcCloud startLocalAudio:TRTCAudioQualityDefault];
2. Beauty Managerを取得し設定
TXBeautyManager *beautyManager = [trtcCloud getBeautyManager];
// 美肌スタイル
[beautyManager setBeautyStyle:TRTCBeautyStyleSmooth];
// 美肌レベル (0-9)
[beautyManager setBeautyLevel:5];
// ホワイトニング (0-9)
[beautyManager setWhitenessLevel:3];
// 赤み補正 (0-9)
[beautyManager setRuddyLevel:2];
// 目の拡大 (0-9)
[beautyManager setEyeScaleLevel:2];
// 顔の細見 (0-9)
[beautyManager setFaceSlimLevel:3];
3. ビルトイン美顔パネルを表示する
#import <TXLiteAVSDK_TRTC/TRTCBeautyPanel.h>
TRTCBeautyPanel *beautyPanel = [[TRTCBeautyPanel alloc] initWithTRTCCloud:trtcCloud frame:CGRectMake(0, self.view.bounds.size.height - 300, self.view.bounds.size.width, 300)];
[self.view addSubview:beautyPanel];
🌟 追加サンプル：動的パラメータ調整
通話中に美顔レベルを変更する例：
- (void)beautyLevelChanged:(float)value {
TXBeautyManager *beautyManager = [trtcCloud getBeautyManager];
[beautyManager setBeautyLevel:value];
}
顔補正プリセットを作る例：
- (void)applyNaturalPreset {
TXBeautyManager *beautyManager = [trtcCloud getBeautyManager];
[beautyManager setBeautyStyle:TRTCBeautyStyleNature];
[beautyManager setBeautyLevel:3];
[beautyManager setWhitenessLevel:2];
[beautyManager setRuddyLevel:1];
}
✅ テスト結果
| 項目 | 結果 |
|---|---|
| 処理速度 | iPhone12でfps低下なし |
| 効果 | 肌補正・目の拡大とも自然に適用 |
| 安定性 | 通話中にON/OFFしてもクラッシュなし |
| UI | ビルトインパネルは分かりやすく操作性が高い |
📝 まとめ
TRTC Beauty SDKは以下の特徴で非常に実用的です：
- SDK一体型で設定がシンプル
- ビルトインUI・プログラム設定両方対応
- 高速・高画質な処理が可能
今後の計画：
- プリセット保存機能の追加
- CDN配信との併用テスト
- 複数カメラ切替との統合