Share via


PhoneAccountHandle.Id Property

Definition

A string that uniquely distinguishes this particular PhoneAccountHandle from all the others supported by the connection service that created it.

public string? Id { [Android.Runtime.Register("getId", "()Ljava/lang/String;", "", ApiSince=23)] get; }
[<get: Android.Runtime.Register("getId", "()Ljava/lang/String;", "", ApiSince=23)>]
member this.Id : string

Property Value

A service-specific unique opaque identifier for this PhoneAccountHandle.

Attributes

Remarks

A string that uniquely distinguishes this particular PhoneAccountHandle from all the others supported by the connection service that created it.

A connection service must select identifiers that are stable for the lifetime of their users' relationship with their service, across many Android devices. The identifier should be a stable opaque token which uniquely identifies the user within the service. Depending on how a service chooses to operate, a bad set of identifiers might be an increasing series of integers (0, 1, 2, ...) that are generated locally on each phone and could collide with values generated on other phones or after a data wipe of a given phone.

Important: A non-unique identifier could cause non-deterministic call-log backup/restore behavior.

Java documentation for android.telecom.PhoneAccountHandle.getId().

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

Applies to