Level up your Twilio API skills in TwilioQuest, an educational game for Mac, Windows, and Linux. Download Now

メニュー

Expand
Rate this page:

Thanks for rating this page!

We are always striving to improve our documentation quality, and your feedback is valuable to us. How could this documentation serve you better?

Android SDK

Twilio Programmable Voice SDK for Android allows you to add voice-over-IP (VoIP) calling into your native Android applications.

4.x is the latest release of Programmable Voice SDKs. If you are using an older version, Twilio recommends upgrading to 4.x as soon as possible.

Support for 3.x will cease Jul 1st, 2020.This branch will only receive fixes for critical issues. Check this guide when planning your migration to 4.x.

Support for 2.x will cease Jan 1st, 2020.This branch will only receive fixes for critical issues. Check this guide when planning your migration to 3.x.

Check these Android, iOS Swift and iOS Obj-C guides when planning your migration.

For step-by-step instructions to get up and running with the Android SDK for Programmable Voice, check out the quickstart on Github.

認証と権限付与

Programmable Voice SDKでは、音声アプリケーションにおいて開発者のアプリケーション・サーバーがクライアントのアクセスを許可するための新しい認証と権限付与の仕組みを使用しています。 これはアプリケーションに、Twilioクラウド上の開発者のアカウントでクライアント・アプリケーションの認証セッションを管理するアクセス・トークンを提供することで行われます。 アクセス・トークンはTwilioクライアントの旧バージョンで使用されていたケイパビリティ・トークンとは異なるものです。 ケイパビリティ・トークンは、Programmable Voice SDKでは動作しません。 アクセストークンは旧ケイパビリティ・トークン同様のJWTトークンですが、最新のTwilio SDK全体に渡って使用される、新しくより柔軟性に富んだ形式を使用しています。

管理コンソール

Developer tools and configuration options for Programmable Voice can be found in the Programmable Voice Dashboard. Use the console to create TwiML apps, update push credentials, view logs, and much more.

システム要件

サポートするデバイスとエミュレーター

Programmable Voice Android SDKは armeabi-v7aarm64-v8ax86、およびx86_64の各アーキテクチャー、またこれらのアーキテクチャーのエミュレーター・イメージをサポートしています。

サポートするAPIレベル

本SDKは、Android API Level 16 (Jelly Bean) 以降をサポートしています。

開発者ツール

To build the associated Quickstart project you will need the following tools:

  • Android Studio with installed SDK Platform for API Level 24, as well as the supporting libraries.

SDKのインストール

最新のProgrammable Voice Android SDKをインストールするには、以下の構成を build.gradle ファイルに追加してください:

allprojects {
  repositories {
     jcenter()
  }
}

dependencies {
  // The Voice SDK resides on jCenter
  implementation 'com.twilio:voice-android:3.1.2'
}

Java Compatibility

The SDK source and target compatibility is now set to Java 8. The SDK remains binary compatible with applications that target Java 7. However, maintaining Java 7 binary compatibility is not currently a roadmap priority. In order to facilitate compatibility with future major versions, we recommend developers upgrade their applications to target Java 8. Reference the following snippet:

android {
    compileOptions {
        sourceCompatibility 1.8
        targetCompatibility 1.8
    }
}

マイクの許可を有効にする

Android API レベル 23 以降を対象にするためには、使用しているアプリケーションがマイクへアクセスするためのランタイムパーミッションを確実にリクエストする必要があります。そのためには、次の 2 つの手順を実行します。

まず、Android マニフェストファイルに以下を追加します。

 <uses-permission android:name="android.permission.RECORD_AUDIO"/>

次に、アプリケーションコードでマイクパーミッションをリクエストします。

ActivityCompat.requestPermissions(this,
    new String[]{Manifest.permission.RECORD_AUDIO}, MIC_PERMISSION_REQUEST_CODE);
}

詳細については、公式の Android ドキュメントを参照してください。

Setting up ProGuard Rules

Starting with the Programmable Voice Android SDK 3.2.0 release, the SDK requires an updated set of proguard rules. The following snippets provide the correct proguard rules based on the release used by your application.

Voice Android 3.2.0+

# Twilio Programmable Voice
-keep class com.twilio.** { *; }
-keep class tvo.webrtc.** { *; }
-dontwarn tvo.webrtc.**
-keep class com.twilio.voice.** { *; }
-keepattributes InnerClasses

Voice Android 3.0.0-preview1 to 3.1.2

# Twilio Programmable Voice
-keep class com.twilio.** { *; }
-keep class org.webrtc.** { *; }
-dontwarn org.webrtc.**
-keep class com.twilio.voice.** { *; }
-keepattributes InnerClasses

These rules ensure that the Programmable Voice library is not removed by ProGuard.

お問い合わせ

We are anxious to hear your feedback and help you with any trouble you may encounter. For technical support, file a ticket with our support team or send an email to help@twilio.com.

Rate this page:

ヘルプが必要ですか?

誰しもが一度は考える「コーディングって難しい」。そんな時は、お問い合わせフォームから質問してください。 または、Stack Overflow でTwilioタグのついた情報から欲しいものを探してみましょう。