初めに、Androidアプリプロジェクトを新規作成しておきます。特別な設定は必要ありませんが、最小SDKバージョンをAndroid 2.2(APIレベル8)以上に指定しなければいけない点だけ注意してください。
クライアントアプリを実装するには「Twilio Client SDK for Android」が必要です。以下のURLにアクセスし、ダウンロードしましょう。
ダウンロードしたファイルを解凍すると、libsフォルダがあると思います。そのlibsフォルダの中のファイルをすべてコピーし、Androidアプリプロジェクトのlibsフォルダにペーストします。これでライブラリの導入は完了です。
いよいよ、ここからはAndroidアプリの実装に入ります。
AndroidManifest.xmlに以下の権限を追加しましょう。
<uses-permission android:name="android.permission.INTERNET" /> <uses-permission android:name="android.permission.RECORD_AUDIO" /> <uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" /> <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /> <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
次に、applicationタグ内にTwilioClientServiceを追加します。これはTwilio Client SDKが内部的に使用しているサービスです。「exported="false"」にする必要がある点に注意してください。
<service
android:name="com.twilio.client.TwilioClientService"
android:exported="false" />
以上でAndroidManifest.xmlの修正は終わりです。
Activityを以下のように実装してください。
package jp.classmethod.android.sample.hellotwilio;
import android.os.Bundle;
import android.support.v4.app.FragmentActivity;
import android.support.v4.content.Loader;
import android.util.Log;
import android.view.View;
import android.view.View.OnClickListener;
import android.widget.EditText;
import com.twilio.client.Device;
import com.twilio.client.Twilio;
public class HelloTwilioActivity extends FragmentActivity implements OnClickListener, Twilio.InitListener {
private static final String TAG = HelloTwilioActivity.class.getSimpleName();
private Device mDevice;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_hello_twilio);
// Connectボタン
findViewById(R.id.button).setOnClickListener(this);
// Twilioクライアントを初期化する
Twilio.initialize(getApplicationContext(), this);
}
@Override
public void onInitialized() {
Log.d(TAG, "Twilioクライアントの初期化が完了しました");
}
@Override
public void onError(Exception e) {
Log.e(TAG, "エラーが発生しました:" + e.getLocalizedMessage());
}
@Override
public void onClick(View v) {
}
}
まず最重要なのがonCreate()メソッド内の最後にあるTwilio.initialize()メソッドです。このメソッドはTwilio Client SDKの初期化処理を実行するメソッドのため、Twilio Client SDKを使用したい場合、必ず呼び出す必要があります。
コンストラクタにはContextとTwilio.InitListenerの実装クラスを渡さなければいけないので、Activityに実装します。onInitialized()メソッドは初期化が正常に完了したときに呼び出されます。
Activityに対応するレイアウトには読み上げたいメッセージを入力するEditTextと、発信するときに使うButtonを置きます。
またメンバ変数にあるDeviceインスタンスはTwilioに登録したデバイスを操作するときに使います。各インスタンスは以下の実装で取得するので、今は変数宣言だけしておいてください。
次に「DeviceLoader」というクラスを作ります。このクラスはケイパビリティトークンを取得し、Twilioサービスにデバイスを登録する処理を非同期で行うクラスになります。以下のように実装しましょう。
package jp.classmethod.android.sample.hellotwilio;
import org.apache.http.HttpEntity;
import org.apache.http.HttpResponse;
import org.apache.http.client.HttpClient;
import org.apache.http.client.methods.HttpGet;
import org.apache.http.impl.client.DefaultHttpClient;
import org.apache.http.util.EntityUtils;
import android.content.Context;
import android.support.v4.content.AsyncTaskLoader;
import android.util.Log;
import com.twilio.client.Device;
import com.twilio.client.Twilio;
public class DeviceLoader extends AsyncTaskLoader<Device> {
private static final String TAG = DeviceLoader.class.getSimpleName();
public DeviceLoader(Context context) {
super(context);
}
@Override
public Device loadInBackground() {
try {
// ケイパビリティトークンを取得する
String url = "http://{アプリ名}.herokuapp.com/auth";
HttpClient httpClient = new DefaultHttpClient();
HttpGet get = new HttpGet(url);
HttpResponse res = httpClient.execute(get);
HttpEntity entity = res.getEntity();
String token = EntityUtils.toString(entity);
Log.d(TAG, "トークン:" + token);
// Twilioにデバイスを登録する
return Twilio.createDevice(token, null);
} catch (Exception e) {
Log.e(TAG, "エラー:" + e.getLocalizedMessage());
}
return null;
}
}
ケイパビリティトークンの取得はごく普通のGET処理になります。先ほどサーバに実装したケイパビリティトークンを取得するAPIを呼び出し、ケイパビリティトークンを取得します。
Twilioへのデバイス登録はTwilio.createDevice()メソッドを使います。第1引数にはケイパビリティトークンを渡します。第2引数はDeviceListenerを渡しますが、今回は使わないのでnullを渡します。
Copyright © ITmedia, Inc. All Rights Reserved.