2022年05月13日

WebRTCでスマホのカメラ切り替え(前面-背面)

Agora.io WebSDKを利用したスマホのカメラ切り替えの説明です。
サンプルコードはこちらにあります。
基本的に映像Trackを切り替える事で実現可能ですが、一部Android(HUAWEIやSamsung)で正常に動作しない場合があるので2種類記載します。

資料ダウンロード  【すぐ読める!ガイドブック】ビデオ通話・ライブ配信SDK「Agora」  ビデオ通話やライブ配信の機能をあらゆるアプリケーションに簡単に実装できるSDKの特徴から活用例まで徹底解説! 無料ダウンロード

利用するAPI一覧

  • AgoraRTC.createStream()
  • Stream.replaceTrack()

基本的にはこの2つで実現可能です。

初期のカメラ指定

index.html
var facingMode = "user";
    //中略
    rtc.localStream = AgoraRTC.createStream({
      streamID: rtc.params.uid,
      audio: true,
      video: true,
      screen: false,
      microphoneId: option.microphoneId,
      facingMode: facingMode
    })
    

"facingMode"で前面カメラか背面カメラを選択できます。"user"が前面カメラ、"environment"が背面カメラになります。

手法1

Stream.replaceTrack()で簡単に切り替える方法です。

index.html
if(facingMode == "user"){
      facingMode = "environment";
    }else{
      facingMode = "user";
    }
    var localStream2 = AgoraRTC.createStream({
      video: true,
      audio: false,
      facingMode: facingMode
    });
    
    localStream2.init(function(){
      var newVideoTrack = localStream2.getVideoTrack();
      rtc.localStream.replaceTrack(newVideoTrack);
      rtc.localStream.stop();
      rtc.localStream.play("local_stream");
    });
    

新規で映像ストリームを作成し、そのストリームに差し替える手法になります。
冒頭で記載の通り、この方法では一部正常に動作しません。理由は同時に前面・背面のカメラをオープンさせることができない為です。その代替手法は以下になります。

手法2

一度カメラを閉じて、再度映像を取得してパブリッシュします。(サーバーとの接続は途切れないので、チャネルからの離脱にはなりません)

index.html
if(facingMode == "user"){
      facingMode = "environment";
    }else{
      facingMode = "user";
    }
    rtc.localStream.stop();
    rtc.localStream.close();
    unpublish(rtc);
    var params = serializeformData();
    
    rtc.localStream = AgoraRTC.createStream({
      streamID: rtc.params.uid,
      audio: true,
      video: true,
      screen: false,
      microphoneId: params.microphoneId,
      facingMode: facingMode
    })
    
    rtc.localStream.init(function () {
      rtc.localStream.play("local_stream")
      publish(rtc);
    }, function (err)  {
    })
    

こちらの手法ですべてのスマホに対応ができます。

資料ダウンロード  【一気に読める!】Agora 導入事例集  オンラインフィットネス・カウンセリング、音声サービスやファンサービスなど、バラエティに富んだ導入事例をご紹介! 無料ダウンロード
ブイキューブ

執筆者ブイキューブ

Agoraの日本総代理店として、配信/通話SDKの提供だけでなく、導入支援から行い幅広いコミュニケーションサービスに携わっている。

関連記事

先頭へ戻る