Connection.SendConnectionEvent(String, Bundle) メソッド

定義

名前空間:: Android.Telecom

アセンブリ:: Mono.Android.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

この Connection に関連付けられたイベントに関連付けられたイベントを InCallServiceに送信します。

[Android.Runtime.Register("sendConnectionEvent", "(Ljava/lang/String;Landroid/os/Bundle;)V", "GetSendConnectionEvent_Ljava_lang_String_Landroid_os_Bundle_Handler", ApiSince=25)]
public virtual void SendConnectionEvent(string? e, Android.OS.Bundle? extras);

[<Android.Runtime.Register("sendConnectionEvent", "(Ljava/lang/String;Landroid/os/Bundle;)V", "GetSendConnectionEvent_Ljava_lang_String_Landroid_os_Bundle_Handler", ApiSince=25)>]
abstract member SendConnectionEvent : string * Android.OS.Bundle -> unit
override this.SendConnectionEvent : string * Android.OS.Bundle -> unit

パラメーター

e: String

extras: Bundle

イベントに関連付けられた追加情報を含むオプションのバンドル。

属性: RegisterAttribute

注釈

この Connection に関連付けられたイベントに関連付けられたイベントを InCallServiceに送信します。

接続イベントは、 ConnectionService から InCallService 実装にポイントインタイム情報を通信するために使用されます。カスタム接続イベントの例には、WIFI 呼び出しが LTE に引き渡されたときに UI に通知する方法が含まれます。これは、課金料金が適用される可能性があることをユーザーに通知するために InCall UI が使用する可能性があります。 #EVENT_CALL_MERGE_FAILEDへの呼び出しが正常に完了しなかった場合、Android テレフォニーフレームワークはCall#mergeConference()接続イベントを送信します。接続イベントを使用して、ユーザーに選択を求める UI を InCallService でトリガーすることもできます (呼び出しを行うためにローミングコストを発生させるかどうかなど)。これは、 Call#sendCallEvent(String, Bundle)経由で伝達されます。

イベントは、InCallServiceを介してCall.Callback#onConnectionEvent(Call, String, Bundle)実装に公開されます。

In-Call UI またはサービスがこれらのイベントをどのように処理するかについては、想定しないでください。 ConnectionServiceでは、In-Call UI が一部のイベントを完全に無視することを選択することさえあると想定する必要があります。

com.example.event.MY_EVENT実装間の競合を回避するには、イベントを完全修飾 (ConnectionService など) にする必要があります。さらに、カスタム ConnectionService 実装では、 android.* 名前空間のイベントを再利用したり、この名前空間で新しいイベントの種類を定義したりしないでください。カスタムイベントの種類を定義するときは、追加の Bundle の内容が明確に定義されていることを確認します。このバンドルの追加キーには、イベントの種類 (例: com.example.extra.MY_EXTRA) に似た名前を付ける必要があります。

イベントと関連する追加要素を定義するときは、関連付けられた ConnectionService が更新されたときに動作の一貫性を保つことが重要です。以前の動作をサポートするために構築された古い InCallService 実装との下位互換性を確保するために、非推奨のイベント/追加機能のサポートを維持する必要があります。

Javaドキュメント。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

適用対象