メニュー

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?

DeviceListener インターフェイス リファレンス

Deprecation Notice

The Twilio Client SDK for Android has been deprecated and replaced by Twilio's Programmable Voice SDK.

The Programmable Voice SDK offers many improvements over the Twilio Client SDK, including greater stability, improved backgrounding, and built-in support for push notifications for incoming calls.

If you're just getting started with a Twilio mobile application for voice calling, we recommend you use the Programmable Voice SDK. If you're already using the Twilio Client SDK, you should plan to upgrade to the Programmable Voice SDK as soon as you're able.

Get started with the new Programmable Voice SDK by checking out the quickstart for Programmable Voice SDK for Android on Github.

概要

  • パッケージ : com.twilio.client

DeviceListener インターフェイスは、Device のインスタンスに関連するイベントのコールバックのセットを定義します。

Tasks

名前 概要 Type
onStartListening Device が着信接続の待ち受けを開始した時に呼び出されます。 インスタンス メソッド
onStopListening Device が着信接続の待ち受けを停止した時に呼び出されます。 インスタンス メソッド
onStopListening エラー状態が発生したため Device が着信接続の待ち受けを停止した時に呼び出されます。 インスタンス メソッド
receivePresenceEvents アプリケーションがプレゼンス イベントを受け取るかどうかを問い合わせるために呼び出されます。 インスタンス メソッド
onPresenceChanged 1 つ以上のクライアントのプレゼンス状態が変化した時に呼び出されます。 インスタンス メソッド

メソッド

void onStartListening(Device inDevice)

Device が着信接続の待ち受けを開始した時に呼び出されます。

パラメーター
名前 概要
inDevice 待ち受けを開始した Device インスタンス
戻り値

なし


void onStopListening(Device inDevice)

Device が着信接続の待ち受けを停止した時に呼び出されます。

パラメーター
名前 概要
inDevice 待ち受けを開始した Device インスタンス
戻り値

なし


void onStopListening(Device inDevice, int inErrorCode, String inErrorMessage)

エラー状態が発生したため Device が着信接続の待ち受けを停止した時に呼び出されます。

エラー コードのリストとエラーの意味については、 http://www.twilio.com/docs/client/errorsを参照してください。

パラメーター
名前 概要
inDevice 待ち受けを開始した Device インスタンス
inErrorCode エラーを示すエラー コード
inErrorMessage 人間が読みやすい形式でエラーを記述した文字列
戻り値

なし


boolean receivePresenceEvents(Device inDevice)

アプリケーションがプレゼンス イベントを受け取るかどうかを問い合わせるために呼び出されます。

帯域幅とバッテリー残量は、モバイル機器ではともに貴重なリソースであるため、プレゼンス通知を受信し処理する余計な負荷がかからないようにしたい場合があります。 プレゼンス通知を受信しない場合は、このメソッドを実装し false を返すようにします。 その場合ももちろん DeviceListener.onPresenceChanged()を実装する必要がありますが、中身は空でよく、呼び出されることもありません。

パラメーター
名前 概要
inDevice プレゼンス通知について問い合わせる Device
戻り値

アプリケーションがプレゼンス イベントを受け取るかどうか


void onPresenceChanged(Device inDevice, PresenceEvent inPresenceEvent)

1 つ以上のクライアントのプレゼンス状態が変化した時に呼び出されます。

.receivePresenceEvents()true を返す場合、デバイスが ready になると、このメソッドが利用可能なクライアントにつき 1 回呼び出されます。 その後は、クライアントが利用可能または不可能になった時に呼び出されます。

他の通話が行われている間も、クライアントは利用可能とみなされます。

このメソッドは、クライアントが接続を終了し DeviceListener.onStopListening() メソッドが呼び出される時と、デバイスが再接続した時に再度、利用可能なすべてのオンライン状態のクライアントについて呼び出されます。

PresenceEvent オブジェクトは通話をまたいで再利用される可能性があります。このため、このメソッドの実行後も持続する必要があるデータはすべてコピーすることをお勧めします。

パラメーター
名前 概要
inDevice プレゼンス変更通知を受信する Device
inPresenceEvent 通知を記述する PresenceEvent オブジェクト
戻り値

なし

Rate this page:

ヘルプが必要ですか?

We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd browsing the Twilio tag on Stack Overflow.