tencent cloud

内容紹介

Tencent Real-Time Communication(TRTC)は、携帯電話のライブストリーミングのような縦画面による変化に乏しいユーザーエクスペリエンスとは異なり、横画面と縦画面という2つのユースケースを両立させることが必要です。このため、横画面と縦画面の処理ロジックを対応させる必要があります。ここでは主に、次の事項についてご説明します：

• 縦画面モードを実装する方法。例：WeChatのビデオ通話は典型的な縦画面体験モードです。
• 横画面モードを実装する方法。例：多人数インタラクティブオーディオビデオルームApp（XYLink（小魚易連）など）は多くの場合、横画面モードを採用しています。
• ローカル画面およびリモート画面の回転方向およびフィルモードをカスタマイズする方法。

サポートしているプラットフォーム

縦画面モード

WeChatのビデオ通話のような体験モードを実装したい場合は、2つの作業を行ってください：

1. アプリのUIインターフェースを縦画面に設定する

- (UIInterfaceOrientationMask)application:(UIApplication *)application 
    supportedInterfaceOrientationsForWindow:(UIWindow *)window 
{

    return  UIInterfaceOrientationMaskPortrait ;

}

<activity android:name=".trtc.TRTCMainActivity" android:launchmode="singleTask" android:windowsoftinputmode="adjustPan" android:screenorientation="portrait">

2. SDKで使用する縦画面解像度の設定

TRTCCloudを使用したsetVideoEncoderParamインターフェースにビデオコーデックパラメータを設定する場合は、resModeをTRTCVideoResolutionModePortraitに指定します。
サンプルコードは次のとおりです。

TRTCVideoEncParam* encParam = [TRTCVideoEncParam new];
encParam.videoResolution = TRTCVideoResolution_640_360;
encParam.videoBitrate = 600;
encParam.videoFps = 15;
encParam.resMode = TRTCVideoResolutionModePortrait; //解像度モードを縦画面モードに設定

[trtc setVideoEncoderParam: encParam];

TRTCCloudDef.TRTCVideoEncParam encParam = new TRTCCloudDef.TRTCVideoEncParam();
encParam.videoResolution = TRTCCloudDef.TRTC_VIDEO_RESOLUTION_640_360;
encParam.videoBitrate = 600;
encParam.videoFps = 15;
encParam.videoResolutionMode = TRTCCloudDef.TRTC_VIDEO_RESOLUTION_MODE_PORTRAIT; //解像度モードを縦画面モードに設定
trtc.setVideoEncoderParam(encParam);

横画面モード

アプリに横画面のユーザーエクスペリエンスを提供する場合、縦画面モードと同様の作業を行う必要がありますが、手順1と2のパラメータに対応する調整を行うだけでOKです。
特に手順2では、TRTCVideoEncParamのresMode値は次のとおりとなります：

• iOSプラットフォームではTRTCVideoResolutionModeLandscapeと指定してください。
• AndroidプラットフォームではTRTC_VIDEO_RESOLUTION_MODE_LANDSCAPEと指定してください。

カスタマイズ制御

TRTC SDKにより提供された多数のインターフェース関数は、ローカルおよびリモートの画面の回転方向およびフィルモードをコントロールできます：

GSensorMode

画面の回転はレコーディングやCDN Relayed live streamingの調節に関するさまざまな項目に影響することを考慮すると、TRTC SDKはシンプルな重力センサーの自動調節機能を提供するだけであるので、TRTCCloudのsetGSensorModeインターフェースを介してオンにすることができます。

この機能は、現在180度の上下回転の自動調節のみをサポートしています。つまり、ユーザー自身の携帯電話が上下180度逆さまになっている場合、相手が見る画面の向きが変わらないように維持します（90度または270度回転への適応はまだサポートしていません）。この自動調節はエンコーダーの方向調整に基づいて実装されているため、レコーディングしたビデオやH5端末に表示されるビデオ画面も、元の向きを維持することができます。

注意：

重力センサーの自動調節のもう一つの実装ソリューションでは、各フレームのビデオ情報ごとに現在のビデオの重力方向を対応させた上で、リモートユーザー側でレンダリング方向を自動調節します。ただしこのソリューションでは、レコーディングしたビデオの向きと求めるビデオの向きの一致を維持させるために、追加でトランスコードリソースを導入する必要があるためお勧めできません。