Question 1

ローカルネットワークでは正常に動作するのに、Raspberry Pi上でNgrok経由のMiroTalk C2Cが自分の映像のみ表示され、リモートの音声/映像がない問題を修正する方法

Accepted Answer

この問題は、Ngrok を手動で個別に起動した場合に発生します。MiroTalk C2C には WebRTC トンネリングを自動的に処理する Ngrok 統合機能が組み込まれているため、手動での Ngrok 起動はサポートされていません。解決するには、以下の公式手順に従ってください：
1. https://ngrok.com で無料の Ngrok アカウントに登録し、https://dashboard.ngrok.com/get-started/your-authtoken から認証トークンをコピーします
2. MiroTalk C2C のインストールディレクトリにある `.env` ファイルを編集し、以下の設定を追加します：
```env
NGROK_ENABLED=true
NGROK_AUTH_TOKEN=your_copied_ngrok_auth_token
```
`your_copied_ngrok_auth_token` をコピーしたトークンに置き換えてください。
3. 手動で起動したすべての Ngrok プロセスと実行中の MiroTalk C2C サービスを停止し、`npm start` で MiroTalk C2C を再起動します
4. localhost や手動で作成した Ngrok トンネルではなく、起動時のコンソールログに出力される `ngrokHome` の URL（`.ngrok-free.app` で終わるもの）からサービスにアクセスします
この設定後、リモートの音声とビデオは正常に動作します。

Question 2

MiroTalkでルームの作成とアクセスを許可されたユーザーのみに制限する方法は？

Accepted Answer

.envファイルでOIDC（OpenID Connect）認証を有効にします。OIDC_ENABLED=trueを設定し、OIDC_ISSUER_BASE_URL、OIDC_CLIENT_ID、OIDC_CLIENT_SECRET、その他のパラメータを構成します。完全な制御のために、Auth0のようなマネージドサービスを使用するか、Keycloakでセルフホストすることもできます。これにより、ユーザーは部屋を作成または参加する前に認証を強制され、不正アクセスやサーバーの悪用を防ぎます。

Question 3

iOS Firefoxでカメラ/マイクの許可プロンプトが表示されずにgetUserMedia NotAllowedErrorを修正する方法は？

Accepted Answer

このエラーは通常、iOSのシステムレベルの権限（Firefoxのアプリ内設定やアドレスバーの錠前アイコンの権限コントロールではなく）がFirefoxによるマイクまたはカメラへのアクセスをブロックしている場合に発生するため、権限プロンプトがまったく表示されません。修正するには次の手順に従ってください: 1. iOS標準の設定アプリを開きます。2. インストール済みアプリの一覧で下にスクロールし、Firefoxをタップします。3. MicrophoneとCameraの権限トグルを両方とも有効にします。4. Firefoxを完全に再起動し、影響を受けているWebページを再読み込みして、カメラ/マイクへのアクセスを再試行します。MiroTalkユーザー向け: MiroTalk C2Cは機能するためにカメラとマイクの両方の権限が必要ですが、MiroTalk P2P/SFUは一部またはまったくメディア権限がなくても動作できます。一時的な回避策: Firefoxの権限を調整できない場合は、iOS Safariを使用してサービスにアクセスしてください。

Question 4

MiroTalk C2C で .env ファイルを使用して STUN/TURN を無効化し、空の iceServers を設定するにはどうすればよいですか？

Accepted Answer

.env で両方の新しい環境変数を false に設定します:

STUN_SERVER_ENABLED=false
TURN_SERVER_ENABLED=false

これにより STUN と TURN がオプションになり、WebRTC が空の iceServers を使用できるようになります。これは直接接続またはローカルネットワークのピア接続で機能する可能性があります。ファイルを変更した後、アプリケーションを再起動してください。いずれかのサーバーを再度有効にするには、その値を true に設定し、対応する設定を提供してください。

Question 5

MiroTalk C2C で、OV5647 などの Raspberry Pi CSI カメラをビデオソースとして明示的に選択するにはどうすればよいですか？

Accepted Answer

ブラウザは Linux/device-tree パス /base/soc/i2c0mux/i2c@1/ov5647@36 を直接使用できません。WebRTC は navigator.mediaDevices.enumerateDevices() を通じてカメラを公開し、Web の deviceId でそれらを選択します。

1. CSI カメラを有効化し、システムから認識されることを確認します:
sudo raspi-config nonint do_camera 0
sudo reboot
sudo apt install -y v4l-utils
v4l2-ctl --list-devices
libcamera-hello --list-cameras

2. localhost または HTTPS 経由で Chromium で MiroTalk を開き、カメラ権限を付与します。次に、ブラウザの DevTools コンソールでこれを実行します:
await navigator.mediaDevices.getUserMedia({ video: true });
const cameras = (await navigator.mediaDevices.enumerateDevices())
  .filter(d => d.kind === 'videoinput');
console.table(cameras.map(c => ({ label: c.label, deviceId: c.deviceId })));
カメラ権限が付与されるまで、デバイスラベルは通常空です。

3. mirotalkc2c/frontend/js/client.js 内で、getUserMedia() 呼び出しを見つけ、ラベルまたはハードコードされた deviceId によって CSI カメラを選択します:
const csiCamera = videoDevices.find(d =>
  /ov5647|bcm2835|unicam|mmal|csi/i.test(d.label)
);

const stream = await navigator.mediaDevices.getUserMedia({
  video: csiCamera
    ? { deviceId: { exact: csiCamera.deviceId } }
    : true,
  audio: true,
});
あるいは、ステップ2で表示された正確な deviceId をコピーして、次を使用します:
video: { deviceId: { exact: 'your-camera-device-id' } }
OverconstrainedError が発生する場合は、exact を ideal に置き換えます。

CSI カメラが enumerateDevices() にリストされていない場合、MiroTalk はまだそれを使用できません。問題は、Chromium または V4L2/libcamera スタックがそれを公開していないことです。一時的に動作する USB カメラを使用するか、先にブラウザのカメラ列挙を修正してください。

MiroTalk C2C

主な機能

できないこと

使用例

タグ

はじめ方

類似プロジェクト