インストール
セッションを作成する前に、対象プラットフォーム用の 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
お好みのパッケージマネージャーを使用してインストールしてください:
次に、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 利用可能になる。
- リポジトリで Maven Central が利用可能であることを確認してください:
dependencyResolutionManagement {
repositories {
mavenCentral()
}
}
- Voice SDK の依存関係を追加します:
dependencies {
implementation("com.vonage:client-sdk-voice:latest.release")
}
- 必要な権限を
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
- Xcodeで、[ ] を選択します。 「ファイル」→「パッケージの依存関係を追加...」
- 用途
https://github.com/Vonage/vonage-client-sdk-ios - バージョンルールを指定し、パッケージをターゲットに追加してください
Linker Flag
セット -ObjC ターゲットの ビルド設定 → その他のリンカーフラグ (デバッグおよびリリース)。
Microphone Permission
マイク使用に関する説明をあなたの Info.plist:
<key>NSMicrophoneUsageDescription</key>
<string>Required for voice calls</string>
この設定がない場合、SDKがマイクへのアクセスを要求した際に、iOSはアプリを終了させてしまいます。