セットアップ

システム条件

Sora iOS SDK を利用するアプリケーションの開発に必要なシステム条件を次に示します。

  • iOS 13 以降

  • アーキテクチャ arm64 (シミュレーターの動作は未保証です)

  • macOS 14.3.1 以降

  • Xcode 15.2

  • Swift 5.9.2

  • CocoaPods 1.15.2 以降 (Swift Package Manager を利用する場合は不要です)

  • WebRTC SFU Sora 2023.2.0 以降

Xcode プロジェクトのセットアップ

概要

Sora iOS SDK は CocoaPods または Swift Package Manager を利用してアプリケーションに追加できます。

CocoaPods を利用する

Spec リポジトリを登録する (初回のみ)

Sora iOS SDK は専用の Spec リポジトリで配布しています。 CocoaPods を利用する際は、次の手順で Spec リポジトリをローカルの環境に登録してください。

  1. Spec リポジトリをローカルの Spec リポジトリに登録します。

    $ pod repo add sora-ios-sdk-specs https://github.com/shiguredo/sora-ios-sdk-specs.git
    
  2. Spec のリストを更新します。

    $ pod repo update
    

以上の操作が必要になるのは初回のみです。 プロジェクト生成のたびに実行する必要はありません。

Podfile を用意する

  1. 先頭に次の記述を追加します。 Sora iOS SDK の Spec リポジトリから検索するようにします。

    source 'https://github.com/shiguredo/sora-ios-sdk-specs.git'
    source 'https://github.com/CocoaPods/Specs.git'
    
  2. Sora iOS SDK を利用するターゲットに pod 'Sora', VERSION の形式で Sora ライブラリを追加します。以下に例を示します。

    source 'https://github.com/shiguredo/sora-ios-sdk-specs.git'
    source 'https://github.com/CocoaPods/Specs.git'
    
    platform :ios, '10.0'
    
    target 'SoraQuickStart' do
      use_frameworks!
      pod 'Sora', '2020.7'
    end
    
  3. pod install を実行してライブラリをインストールします。

Swift Package Manager を利用する

パッケージを追加する

  1. Xcodeのメニューから[File]-[Add Packages...] を選択します

  2. 検索ボックスに https://github.com/shiguredo/sora-ios-sdk を入力します

_images/spm_package_repository.png
  1. 利用するSDK のバージョンを選択して [Add Package]を選択します

_images/spm_package_version.png
  1. Sora, WebRTC の両方を選択して [Add Package]を選択します

_images/spm_select_package.png

Info.plist ファイルを編集する

Info.plist ファイルにカメラとマイクの用途を記述します。 この記述を追加しないとアプリケーションが強制終了するので、必ず記述してください。

  • カメラの用途: "Privacy - Camera Usage Description"

  • マイクの用途: "Privacy - Microphone Usage Description"

設定例:

_images/privacy_settings.png
© Copyright 2018-2024, Shiguredo Inc. Created using Sphinx 7.2.6