Connection.SendConnectionEvent(String, Bundle) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Sendet ein Diesem Ereignis zugeordnete Connection Ereignis mit zugeordneten Ereignis-Extras an die 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 -> unitParameter
- e
- String
- extras
- Bundle
Optionales Bundle, das zusätzliche Informationen enthält, die dem Ereignis zugeordnet sind.
- Attribute
Hinweise
Sendet ein Diesem Ereignis zugeordnete Connection Ereignis mit zugeordneten Ereignis-Extras an die InCallService.
Verbindungsereignisse werden verwendet, um Punkt-in-Zeit-Informationen von einer ConnectionServiceInCallService Implementierung zu kommunizieren. Ein Beispiel für ein benutzerdefiniertes Verbindungsereignis umfasst die Benachrichtigung der Benutzeroberfläche, wenn ein WLAN-Anruf an LTE übergeben wurde, mit dem die InCall-Benutzeroberfläche den Benutzer darüber informieren kann, dass Abrechnungsgebühren anfallen können. Das Android-Telefonieframework sendet das #EVENT_CALL_MERGE_FAILED Verbindungsereignis, wenn ein Anruf Call#mergeConference() nicht erfolgreich abgeschlossen wurde. Ein Verbindungsereignis kann auch verwendet werden, um die Benutzeroberfläche auszulösen, in der InCallService der Benutzer aufgefordert wird, eine Auswahl zu treffen (z. B. ob sie Roamingkosten für das Tätigen eines Anrufs verursachen möchten), die über Call#sendCallEvent(String, Bundle)die Kommunikation zurückgesetzt wird.
Ereignisse werden InCallService implementierungen über Call.Callback#onConnectionEvent(Call, String, Bundle).
Es sollten keine Annahmen darüber getroffen werden, wie eine In-Call UI oder ein Dienst diese Ereignisse behandelt. Es ConnectionService muss davon ausgegangen werden, dass sich die In-Call UI sogar dafür entscheiden konnte, einige Ereignisse vollständig zu ignorieren.
Ereignisse sollten vollqualifizierte (z. B. com.example.event.MY_EVENT) sein, um Konflikte zwischen ConnectionService Implementierungen zu vermeiden. Darüber hinaus dürfen benutzerdefinierte ConnectionService Implementierungen keine Ereignisse im android.* Namespace neu verwenden und keine neuen Ereignistypen in diesem Namespace definieren. Stellen Sie beim Definieren eines benutzerdefinierten Ereignistyps sicher, dass der Inhalt der Extras Bundle klar definiert ist. Zusätzliche Schlüssel für dieses Bündel sollten dem Ereignistyp (z. B. com.example.extra.MY_EXTRA) ähneln.
Beim Definieren von Ereignissen und den zugehörigen Extras ist es wichtig, das Verhalten konsistent zu halten, wenn die zugeordnete ConnectionService Datei aktualisiert wird. Unterstützung für veraltete Ereignisse/Extras sollte ich beibehalten, um die Abwärtskompatibilität mit älteren InCallService Implementierungen sicherzustellen, die erstellt wurden, um das ältere Verhalten zu unterstützen.
Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.