インストール

セッションを作成する前に、対象プラットフォーム用の Client SDK をインストールしてください。

プラットフォーム要件

プラットフォーム 最小バージョン 必要な権限
アンドロイド SDK 23(Android 6.0) INTERNET, RECORD_AUDIO
iOS iOS 15.0 マイクの使用方法 (NSMicrophoneUsageDescription (Info.plist 内)
ウェブ WebRTCに対応した最新のブラウザ(Chrome 70以降、Firefox 60以降、Safari 14.1以降、Edge 79以降) マイクへのアクセス(ブラウザから要求されます)

警告:本番環境でのバージョン固定 以下の例では、 latest.release (Android) および @latest (CDN)と簡略化して表記します。本番環境のApplicationsでは、常に特定のバージョンに固定してください(例: com.vonage:client-sdk-voice:2.3.1 または @vonage/client-sdk@2.3.1) これにより、ビルドの再現性を確保し、アップグレード時の予期せぬ互換性破綻を防ぐことができます。以下の項目を確認してください。 変更履歴 アップグレードを行う前に、リリースノートをご確認ください。

NPM

お好みのパッケージマネージャーを使用してインストールしてください:

npm i @vonage/client-sdk # or yarn add @vonage/client-sdk # or pnpm add @vonage/client-sdk # or bun add @vonage/client-sdk

次に、Client SDK をインポートします:

import clientSDK from '@vonage/client-sdk';

CDN

<script src="https://cdn.jsdelivr.net/npm/@vonage/client-sdk@latest/dist/vonageClientSDK.min.js"></script>

マイクの使用

通話が開始されると、ブラウザはユーザーにマイクのアクセス許可を求めるプロンプトを表示します。マニフェストや設定は不要ですが、この機能を利用するには、ページが HTTPS(または localhost)経由で配信されている必要があります。 getUserMedia 利用可能になる。

  1. リポジトリで Maven Central が利用可能であることを確認してください:
dependencyResolutionManagement {
    repositories {
        mavenCentral()
    }
}
  1. Voice SDK の依存関係を追加します:
dependencies {
    implementation("com.vonage:client-sdk-voice:latest.release")
}
  1. 必要な権限を AndroidManifest.xml:
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.RECORD_AUDIO" />

また、以下についても申請する必要があります RECORD_AUDIO 実行時に、通話を発信または着信する前に(Android 6.0以降)。

CocoaPods

PodfileにClient SDKを追加してください:

target 'YourApp' do
  use_frameworks!
  pod 'VonageClientSDKVoice'
end

Swift Package Manager

  1. Xcodeで、[ ] を選択します。 「ファイル」→「パッケージの依存関係を追加...」
  2. 用途 https://github.com/Vonage/vonage-client-sdk-ios
  3. バージョンルールを指定し、パッケージをターゲットに追加してください

Linker Flag

セット -ObjC ターゲットの ビルド設定 → その他のリンカーフラグ (デバッグおよびリリース)。

Microphone Permission

マイク使用に関する説明をあなたの Info.plist:

<key>NSMicrophoneUsageDescription</key>
<string>Required for voice calls</string>

この設定がない場合、SDKがマイクへのアクセスを要求した際に、iOSはアプリを終了させてしまいます。