質問と答え

一般

Sora がなくても使えますか?

Sora iOS SDK は Sora 専用です。 Sora 以外の環境では動作しません。

WebRTC ライブラリをビルドする必要はありますか?

ありません。 Sora iOS SDK に必要な WebRTC ライブラリは、ビルド済みのバイナリを https://github.com/shiguredo/sora-webrtc-ios にて提供しています。

Objective-C で使えますか?

使えません。 Sora iOS SDK は Swift 専用です。

ソースコードをダウンロードしたい

git clone などでソースコードをダウンロードする場合は、タグを指定するか master ブランチを選択してください。 develop ブランチは動作の保証ができませんので注意してください。

Bitcode に対応していますか?

対応しています。

他の SDK (JavaScript, Android) と API は共通ですか?

共通していません。 可能な範囲で基本的な設計を合わせていますが、それぞれのプラットフォームで最適な API を用意しています。

ライセンス

Sora iOS SDK は有償ですか?

Sora iOS SDK はオープンソースライセンス Apache License 2.0 で配布しています。

リリース

リリースのタイミングは決まっていますか?

Sora の新しいバージョンのリリース時に必要があればアップデートします。 それ以外のタイミングは特に決まっていません。

サポート

有償サポートは受けられますか?

現在 Sora iOS SDK の有償サポートは提供していません。

サポートは電話で受け付けていますか?

受け付けていません。 質問やバグ報告は GitHub の Issues の利用をお願いします。

質問やバグ報告はどこで行えますか?

GitHub の Issues の利用をお願いします。 ただし、 Sora のライセンス契約の有無に関わらず、 Issue への応答時間と問題の解決を保証しませんのでご了承ください。

Issue の内容はどのように書けばいいですか?

使い方の質問やバグ報告であれば、次の開発環境のバージョンを「メジャーバージョン、マイナーバージョン、メンテナンスバージョン」まで含めて書いてください (Xcode 9.0 など) 。 これらの開発環境はメンテナンスバージョンの違いでも Sora iOS SDK の挙動が変わる可能性があります。

  • Sora iOS SDK
  • Mac OS X
  • Xcode
  • Swift
  • iOS
  • Carthage

使い方

開発ガイド も参考にしてください。

Sora サーバーに接続できません

まずは wscat などのツールで WebSocket の接続の成否を確認してください。 wscat であれば次のコマンドで接続の成否を確認できます:

$ wscat --connect [URL]

もし接続できなければ URL を確認してください。

  • プロトコルは "ws" または "wss" のどちらかを指定していますか? Sora iOS SDK のシグナリングは WebSocket のみ対応しています。
  • ポート番号に間違いはありませんか? "wss" であれば通常は 443 です。
  • パスに signaling を指定していますか?

URL に問題がないのに WebSocket 接続ができない場合は、 Sora の設定やネットワーク環境を確認してください。

パブリッシャーとサブスクライバーは一つの接続を共有しますか?

いいえ、パブリッシャーとサブスクライバーはそれぞれ個別に Sora サーバーに接続します。 一方の接続状態はもう一方の接続に影響しません。 これは Sora の仕様です。

カメラとマイクの初期化はどのように行うべきですか?

Sora iOS SDK は接続が完了するとカメラとマイクを初期化して使用可能にするため、ユーザーが初期化を行う必要はありません。

サブスクライバーの接続時にマイクへのアクセス権を要求されます

パブリッシャーを使用しないにも関わらず、サブスクライバーの接続時にマイクへのアクセス権を要求される場合があります。 これは WebRTC フレームワークの仕様であり、実際のマイクの使用時までアクセス権の要求を遅延させることはできません。

アプリケーションが強制終了します

SDK を組み込んだアプリケーションが強制終了する場合、一つの原因として Info.plist ファイルにカメラとマイクの用途が記述されていない可能性があります。 そうであれば Info.plist にカメラとマイクの用途を記述してください。

どのようなイベントハンドラが用意されていますか?

Sora iOS SDK は次のイベントハンドラを提供しています。 詳しくは API リファレンス を参照してください。

  • WebSocket (WebSocketHandlers)
  • シグナリング (SignalingHandlers)
  • ピア接続 (PeerConnectionHandlers)
  • メディアストリーム (MediaStreamHandlers)
  • メディアチャネル (MediaChannelHandlers)