tencent cloud

フィードバック

リアルタイム画面共有(Mac)

最終更新日:2024-07-19 15:12:39
    Tencent Cloud TRTC は画面共有機能をサポートし、Macプラットフォームにおける画面共有はビッグストリーム共有とサブストリーム共有の2つのスキームをサポートします。
    サブストリーム共有 TRTCでは、画面共有のための「サブストリーム(substream)」という1チャネルのアップストリームのビデオストリームを個別にスタートできます。サブストリーム共有は、キャスターがカメラ画面とスクリーン画面の両方を同時にアップロードします。これはTencentMeetingの使用スキームであり、startScreenCapture インターフェースを呼び出す場合に、TRTCVideoStreamTypeパラメータをTRTCVideoStreamTypeSub に指定して、このモードをイネーブルできます。このストリーム画面を閲覧するには専用のstartRemoteSubStreamViewインターフェースを使用する必要があります。
    ビッグストリーム共有 TRTCでは、通常、カメラが動くチャネルを「ビッグストリーム(bigstream)」といい、ビッグストリーム共有は、カメラチャネルを使用して画面を共有します。このモードでは、キャスターは、アップストリームのカメラ画面、もしくはアップストリームのスクリーン画面のいずれかのアップストリームのビデオストリームを1チャンネルのみ有し、両者は相互に排他的です。startScreenCaptureインターフェースを呼び出す場合に、TRTCVideoStreamTypeパラメータをTRTCVideoStreamTypeBigに指定し、このモードをイネーブルできます。

    サポートするプラットフォーム

    iOS
    Android
    Mac OS
    Windows
    Electron
    Chromeブラウザ

    共有ターゲットの取得

    getScreenCaptureSourcesWithThumbnailSizeを介して共有可能なウィンドウをリストアップでき、共有可能な各ターゲットはいずれもTRTCScreenCaptureSourceInfoオブジェクトです。
    Mac OS内のデスクトップスクリーンも共有可能なターゲットであり、通常のMacウィンドウのtypeはTRTCScreenCaptureSourceTypeWindowで、デスクトップスクリーンのtypeはTRTCScreenCaptureSourceTypeScreenです。
    typeに加え、各TRTCScreenCaptureSourceInfoには次のフィールド情報があります。
    フィールド
    タイプ
    意味
    type
    TRTCScreenCaptureSourceType
    キャプチャソースタイプ:指定タイプはウィンドウまたはスクリーン
    sourceId
    NSString
    キャプチャソースID:ウィンドウの場合、このフィールドはウィンドウハンドルを示します;
    スクリーンの場合、このフィールドはスクリーンIDを示します
    sourceName
    NSString
    ウィンドウ名、画面である場合は、Screen0 Screen1...を返します
    extInfo
    NSDictionary
    共有ウィンドウの追加情報
    thumbnail
    NSImage
    ウィンドウサムネイル
    icon
    NSImage
    ウィンドウアイコン
    上述のこれらの情報があれば、ユーザーの選択のために共有可能なターゲットを一覧表示するシンプルなリストページを実現できます。

    共有ターゲットの選択

    TRTC SDKは3種類の共有モードをサポートしており、selectScreenCaptureTargetを介して指定できます。
    全画面の共有: 全スクリーンウィンドウの共有であり、マルチモニター分割画面をサポートします。1つのtypeがTRTCScreenCaptureSourceTypeScreenのscreenSourceパラメータを指定し、rectを{ 0, 0, 0, 0 }に設定する必要があります。
    指定領域の共有: スクリーンの特定領域の共有であり、ユーザーが領域の位置座標を決定する必要があります。1つのtypeがTRTCScreenCaptureSourceTypeScreenのscreenSourceパラメータを指定し、captureRectを{100、100、300、300}などの非NULLに設定する必要があります。
    指定ウィンドウの共有: ターゲットウィンドウのコンテンツを共有するには、ユーザーが共有したいウィンドウを指定する必要があります。1つのtypeがTRTCScreenCaptureSourceTypeWindowのscreenSourceパラメータを指定し、captureRectを{ 0, 0, 0, 0 }に設定する必要があります。
    説明:
    2つの追加パラメータ:
    パラメータcapturesCursorはマウスポインタをキャプチャするかどうかを指定するために使用されます。
    パラメータhighlightは共有するウィンドウを強調表示するかどうかを指定し、キャプチャされた画像がブロックされた場合に、オクルージョンを移動するようユーザーに促すために使用されます。(この部分のUI特殊効果は、SDK内で実現されます)

    画面共有の開始

    共有ターゲットを選択した後、startScreenCaptureインターフェースを使用して画面共有を起動することができます。
    2つの関数pauseScreenCapturestopScreenCaptureの違いは、pauseはスクリーンコンテンツのキャプチャを停止し、その瞬間のスクリーンパッドを一時停止するため、resumeScreenCaptureまで最後の画面がリモート側に表示され続けることです。
    /**
    * 7.6 【画面共有】画面共有の起動
    * @param viewレンダリングウィジェットが配置される親ウィジェット
    */
    - (void)startScreenCapture:(NSView *)view;
    
    /**
    * 7.7 【画面共有】画面キャプチャの停止
    * @return 0:成功 <0:失敗
    */
    - (int)stopScreenCapture;
    
    /**
    * 7.8 【画面共有】画面共有の一時停止
    * @return 0:成功 <0:失敗
    */
    - (int)pauseScreenCapture;
    
    /**
    * 7.9 【画面共有】画面共有のリカバー
    *
    * @return 0:成功 <0:失敗
    */
    - (int)resumeScreenCapture;

    画質の設定

    setSubStreamEncoderParamインターフェースを介して解像度、ビットレートとフレームレートを含む画面共有の画面品質を設定できます。推奨する参考値を以下に提示します。
    解像度レベル
    解像度
    フレームレート
    ビットレート
    超高精細(HD+)
    1920 × 1080
    10
    800kbps
    高精細(HD)
    1280 × 720
    10
    600kbps
    標準(SD)
    960 × 720
    10
    400kbps

    画面共有の確認

    Mac/Windows画面共有の確認 ルームにいるMac/Windowsユーザーが画面共有を起動し、サブストリームを介して共有を実行します。ルームにいるその他のユーザーは、TRTCCloudDelegate内のonUserSubStreamAvailableイベントを介してこの通知を受け取ります。 画面共有を確認したいユーザーはstartRemoteSubStreamViewインターフェースを介して、リモートユーザーのサブストリーム画面のレンダリングを起動することができます。
    Android/iOS画面共有の確認 ユーザーがAndroid / iOSを介して画面共有を実行する場合は、メインストリームを介して共有を実行します。ルームにいるその他ユーザーはTRTCCloudDelegateの中のonUserVideoAvailableイベントを介してこの通知を受け取ります。 画面共有を確認したいユーザーはstartRemoteViewインターフェースを介して、リモートユーザーのメインストリーム画面のレンダリングを起動することができます。
    //サンプルコード:画面共有の画面を見る
    
    - (void)onUserSubStreamAvailable:(NSString *)userId available:(BOOL)available {
    if (available) {
    [self.trtcCloud startRemoteSubStreamView:userId view:self.capturePreviewWindow.contentView];
    } else {
    [self.trtcCloud stopRemoteSubStreamView:userId];
    }
    }

    よくあるご質問

    1つのルームで同時にいくつの画面を共有できますか。 現在、1つのTRTCオーディオ・ビデオルームで共有できる画面は1つだけです。
    ウィンドウの共有(SourceTypeWindow)を指定し、ウィンドウのサイズが変化した場合は、ビデオストリームの解像度も変化しますか。 デフォルトでは、SDK内で共有ウィンドウのサイズに従ってエンコーディングパラメータを自動的に調整します。 解像度を固定する必要がある場合は、setSubStreamEncoderParamインターフェースを呼び出し画面共有のエンコーディングパラメータを設定するか、またはstartScreenCaptureを呼び出すときに、対応するエンコーディングパラメータを指定する必要があります。
    お問い合わせ

    カスタマーサービスをご提供できるため、ぜひお気軽にお問い合わせくださいませ。

    テクニカルサポート

    さらにサポートが必要な場合は、サポートチケットを送信して弊社サポートチームにお問い合わせください。24時間365日のサポートをご提供します。

    電話サポート(24 時間365日対応)