Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 0e094d92 authored by Evan Charlton's avatar Evan Charlton
Browse files

Apply @hide / @SystemApi to android.telecom.* 

Move the android.telecom.* namespace back to @hide, and also mark it
with @SystemApi so that system-privileged apps can use them.

Bug: 18302450
Change-Id: I33ae1b9b0dfdb1c5eff51ca3c829196bcfc9411c
parent 6c912b7d

api/current.txt

+0 −337
Original line number Diff line number Diff line
@@ -113,9 +113,6 @@ package android { 
    field public static final java.lang.String RECEIVE_SMS = "android.permission.RECEIVE_SMS";

    field public static final java.lang.String RECEIVE_WAP_PUSH = "android.permission.RECEIVE_WAP_PUSH";

    field public static final java.lang.String RECORD_AUDIO = "android.permission.RECORD_AUDIO";

    field public static final java.lang.String REGISTER_CALL_PROVIDER = "android.permission.REGISTER_CALL_PROVIDER";

    field public static final java.lang.String REGISTER_CONNECTION_MANAGER = "android.permission.REGISTER_CONNECTION_MANAGER";

    field public static final java.lang.String REGISTER_SIM_SUBSCRIPTION = "android.permission.REGISTER_SIM_SUBSCRIPTION";

    field public static final java.lang.String REORDER_TASKS = "android.permission.REORDER_TASKS";

    field public static final deprecated java.lang.String RESTART_PACKAGES = "android.permission.RESTART_PACKAGES";

    field public static final java.lang.String SEND_RESPOND_VIA_MESSAGE = "android.permission.SEND_RESPOND_VIA_MESSAGE";
@@ -28094,350 +28091,16 @@ package android.system { 














package android.telecom {



























  public final class AudioState implements android.os.Parcelable {













    ctor public AudioState(boolean, int, int);













    ctor public AudioState(android.telecom.AudioState);













    method public int describeContents();













    method public void writeToParcel(android.os.Parcel, int);













    field public static final android.os.Parcelable.Creator<android.telecom.AudioState> CREATOR;













    field public static final int ROUTE_BLUETOOTH = 2; // 0x2













    field public static final int ROUTE_EARPIECE = 1; // 0x1













    field public static final int ROUTE_SPEAKER = 8; // 0x8













    field public static final int ROUTE_WIRED_HEADSET = 4; // 0x4













    field public static final int ROUTE_WIRED_OR_EARPIECE = 5; // 0x5













    field public final boolean isMuted;













    field public final int route;













    field public final int supportedRouteMask;













  }

























  public abstract class Conference {













    ctor public Conference(android.telecom.PhoneAccountHandle);













    method public final boolean addConnection(android.telecom.Connection);













    method public final void destroy();













    method public final android.telecom.AudioState getAudioState();













    method public final int getCapabilities();













    method public final java.util.List<android.telecom.Connection> getConferenceableConnections();













    method public final java.util.List<android.telecom.Connection> getConnections();













    method public final android.telecom.DisconnectCause getDisconnectCause();













    method public final android.telecom.PhoneAccountHandle getPhoneAccountHandle();













    method public android.telecom.Connection getPrimaryConnection();













    method public final int getState();













    method public void onAudioStateChanged(android.telecom.AudioState);













    method public void onConnectionAdded(android.telecom.Connection);













    method public void onDisconnect();













    method public void onHold();













    method public void onMerge(android.telecom.Connection);













    method public void onMerge();













    method public void onPlayDtmfTone(char);













    method public void onSeparate(android.telecom.Connection);













    method public void onStopDtmfTone();













    method public void onSwap();













    method public void onUnhold();













    method public final void removeConnection(android.telecom.Connection);













    method public final void setActive();













    method public final void setCapabilities(int);













    method public final void setConferenceableConnections(java.util.List<android.telecom.Connection>);













    method public final void setDisconnected(android.telecom.DisconnectCause);













    method public final void setOnHold();













  }

























  public abstract class Connection {













    ctor public Connection();













    method public static android.telecom.Connection createCanceledConnection();













    method public static android.telecom.Connection createFailedConnection(android.telecom.DisconnectCause);













    method public final void destroy();













    method public final android.net.Uri getAddress();













    method public final int getAddressPresentation();













    method public final boolean getAudioModeIsVoip();













    method public final android.telecom.AudioState getAudioState();













    method public final int getCallCapabilities();













    method public final java.lang.String getCallerDisplayName();













    method public final int getCallerDisplayNamePresentation();













    method public final android.telecom.Conference getConference();













    method public final java.util.List<android.telecom.Connection> getConferenceableConnections();













    method public final android.telecom.DisconnectCause getDisconnectCause();













    method public final int getState();













    method public final android.telecom.StatusHints getStatusHints();













    method public final boolean isRingbackRequested();













    method public void onAbort();













    method public void onAnswer();













    method public void onAudioStateChanged(android.telecom.AudioState);













    method public void onDisconnect();













    method public void onHold();













    method public void onPlayDtmfTone(char);













    method public void onPostDialContinue(boolean);













    method public void onReject();













    method public void onSeparate();













    method public void onStateChanged(int);













    method public void onStopDtmfTone();













    method public void onUnhold();













    method public final void setActive();













    method public final void setAddress(android.net.Uri, int);













    method public final void setAudioModeIsVoip(boolean);













    method public final void setCallCapabilities(int);













    method public final void setCallerDisplayName(java.lang.String, int);













    method public final void setConferenceableConnections(java.util.List<android.telecom.Connection>);













    method public final void setConnectionService(android.telecom.ConnectionService);













    method public final void setDialing();













    method public final void setDisconnected(android.telecom.DisconnectCause);













    method public final void setInitialized();













    method public final void setInitializing();













    method public final void setOnHold();













    method public final void setPostDialWait(java.lang.String);













    method public final void setRingbackRequested(boolean);













    method public final void setRinging();













    method public final void setStatusHints(android.telecom.StatusHints);













    method public static java.lang.String stateToString(int);













    field public static final int STATE_ACTIVE = 4; // 0x4













    field public static final int STATE_DIALING = 3; // 0x3













    field public static final int STATE_DISCONNECTED = 6; // 0x6













    field public static final int STATE_HOLDING = 5; // 0x5













    field public static final int STATE_INITIALIZING = 0; // 0x0













    field public static final int STATE_NEW = 1; // 0x1













    field public static final int STATE_RINGING = 2; // 0x2













  }

























  public final class ConnectionRequest implements android.os.Parcelable {













    ctor public ConnectionRequest(android.telecom.PhoneAccountHandle, android.net.Uri, android.os.Bundle);













    method public int describeContents();













    method public android.telecom.PhoneAccountHandle getAccountHandle();













    method public android.net.Uri getAddress();













    method public android.os.Bundle getExtras();













    method public void writeToParcel(android.os.Parcel, int);













    field public static final android.os.Parcelable.Creator<android.telecom.ConnectionRequest> CREATOR;













  }

























  public abstract class ConnectionService extends android.app.Service {













    ctor public ConnectionService();













    method public final void addConference(android.telecom.Conference);













    method public final void addExistingConnection(android.telecom.PhoneAccountHandle, android.telecom.Connection);













    method public final void conferenceRemoteConnections(android.telecom.RemoteConnection, android.telecom.RemoteConnection);













    method public final android.telecom.RemoteConnection createRemoteIncomingConnection(android.telecom.PhoneAccountHandle, android.telecom.ConnectionRequest);













    method public final android.telecom.RemoteConnection createRemoteOutgoingConnection(android.telecom.PhoneAccountHandle, android.telecom.ConnectionRequest);













    method public final java.util.Collection<android.telecom.Connection> getAllConnections();













    method public final android.os.IBinder onBind(android.content.Intent);













    method public void onConference(android.telecom.Connection, android.telecom.Connection);













    method public android.telecom.Connection onCreateIncomingConnection(android.telecom.PhoneAccountHandle, android.telecom.ConnectionRequest);













    method public android.telecom.Connection onCreateOutgoingConnection(android.telecom.PhoneAccountHandle, android.telecom.ConnectionRequest);













    method public void onRemoteConferenceAdded(android.telecom.RemoteConference);













    method public void onRemoteExistingConnectionAdded(android.telecom.RemoteConnection);













    field public static final java.lang.String SERVICE_INTERFACE = "android.telecom.ConnectionService";













  }

























  public final class DisconnectCause implements android.os.Parcelable {













    ctor public DisconnectCause(int);













    ctor public DisconnectCause(int, java.lang.String);













    ctor public DisconnectCause(int, java.lang.CharSequence, java.lang.CharSequence, java.lang.String);













    ctor public DisconnectCause(int, java.lang.CharSequence, java.lang.CharSequence, java.lang.String, int);













    method public int describeContents();













    method public int getCode();













    method public java.lang.CharSequence getDescription();













    method public java.lang.CharSequence getLabel();













    method public java.lang.String getReason();













    method public int getTone();













    method public void writeToParcel(android.os.Parcel, int);













    field public static final int BUSY = 7; // 0x7













    field public static final int CANCELED = 4; // 0x4













    field public static final int CONNECTION_MANAGER_NOT_SUPPORTED = 10; // 0xa













    field public static final android.os.Parcelable.Creator<android.telecom.DisconnectCause> CREATOR;













    field public static final int ERROR = 1; // 0x1













    field public static final int LOCAL = 2; // 0x2













    field public static final int MISSED = 5; // 0x5













    field public static final int OTHER = 9; // 0x9













    field public static final int REJECTED = 6; // 0x6













    field public static final int REMOTE = 3; // 0x3













    field public static final int RESTRICTED = 8; // 0x8













    field public static final int UNKNOWN = 0; // 0x0













  }

























  public class GatewayInfo implements android.os.Parcelable {













    method public int describeContents();













    method public android.net.Uri getGatewayAddress();













    method public java.lang.String getGatewayProviderPackageName();













    method public android.net.Uri getOriginalAddress();













    method public boolean isEmpty();













    method public void writeToParcel(android.os.Parcel, int);













    field public static final android.os.Parcelable.Creator<android.telecom.GatewayInfo> CREATOR;













  }

























  public class PhoneAccount implements android.os.Parcelable {













    method public static android.telecom.PhoneAccount.Builder builder(android.telecom.PhoneAccountHandle, java.lang.CharSequence);













    method public int describeContents();













    method public android.telecom.PhoneAccountHandle getAccountHandle();













    method public android.net.Uri getAddress();













    method public int getCapabilities();













    method public int getColor();













    method public android.graphics.drawable.Drawable getIcon(android.content.Context);













    method public android.graphics.Bitmap getIconBitmap();













    method public java.lang.String getIconPackageName();













    method public int getIconResId();













    method public java.lang.CharSequence getLabel();













    method public java.lang.CharSequence getShortDescription();













    method public android.net.Uri getSubscriptionAddress();













    method public java.util.List<java.lang.String> getSupportedUriSchemes();













    method public boolean hasCapabilities(int);













    method public boolean supportsUriScheme(java.lang.String);













    method public void writeToParcel(android.os.Parcel, int);













    field public static final int CAPABILITY_CONNECTION_MANAGER = 1; // 0x1













    field public static final int CAPABILITY_PLACE_EMERGENCY_CALLS = 16; // 0x10













    field public static final int CAPABILITY_SIM_SUBSCRIPTION = 4; // 0x4













    field public static final android.os.Parcelable.Creator<android.telecom.PhoneAccount> CREATOR;













    field public static final int NO_COLOR = -1; // 0xffffffff













    field public static final java.lang.String SCHEME_SIP = "sip";













    field public static final java.lang.String SCHEME_TEL = "tel";













    field public static final java.lang.String SCHEME_VOICEMAIL = "voicemail";













  }

























  public static class PhoneAccount.Builder {













    ctor public PhoneAccount.Builder(android.telecom.PhoneAccountHandle, java.lang.CharSequence);













    ctor public PhoneAccount.Builder(android.telecom.PhoneAccount);













    method public android.telecom.PhoneAccount build();













    method public android.telecom.PhoneAccount.Builder setAddress(android.net.Uri);













    method public android.telecom.PhoneAccount.Builder setCapabilities(int);













    method public android.telecom.PhoneAccount.Builder setColor(int);













    method public android.telecom.PhoneAccount.Builder setIconBitmap(android.graphics.Bitmap);













    method public android.telecom.PhoneAccount.Builder setIconPackageName(java.lang.String);













    method public android.telecom.PhoneAccount.Builder setIconResId(int);













    method public android.telecom.PhoneAccount.Builder setShortDescription(java.lang.CharSequence);













    method public android.telecom.PhoneAccount.Builder setSubscriptionAddress(android.net.Uri);













    method public android.telecom.PhoneAccount.Builder setSupportedUriSchemes(java.util.List<java.lang.String>);













  }

























  public class PhoneAccountHandle implements android.os.Parcelable {













    ctor public PhoneAccountHandle(android.content.ComponentName, java.lang.String);













    method public int describeContents();













    method public android.content.ComponentName getComponentName();













    method public java.lang.String getId();













    method public void writeToParcel(android.os.Parcel, int);













    field public static final android.os.Parcelable.Creator<android.telecom.PhoneAccountHandle> CREATOR;













  }

























  public final class PhoneCapabilities {













    method public static java.lang.String toString(int);













    field public static final int ALL = 12527; // 0x30ef













    field public static final int DISCONNECT_FROM_CONFERENCE = 8192; // 0x2000













    field public static final int HOLD = 1; // 0x1













    field public static final int MANAGE_CONFERENCE = 128; // 0x80













    field public static final int MERGE_CONFERENCE = 4; // 0x4













    field public static final int MUTE = 64; // 0x40













    field public static final int RESPOND_VIA_TEXT = 32; // 0x20













    field public static final int SEPARATE_FROM_CONFERENCE = 4096; // 0x1000













    field public static final int SUPPORT_HOLD = 2; // 0x2













    field public static final int SWAP_CONFERENCE = 8; // 0x8













  }

























  public final class RemoteConference {













    method public void disconnect();













    method public final int getCallCapabilities();













    method public java.util.List<android.telecom.RemoteConnection> getConferenceableConnections();













    method public final java.util.List<android.telecom.RemoteConnection> getConnections();













    method public android.telecom.DisconnectCause getDisconnectCause();













    method public final int getState();













    method public void hold();













    method public void merge();













    method public void playDtmfTone(char);













    method public final void registerCallback(android.telecom.RemoteConference.Callback);













    method public void separate(android.telecom.RemoteConnection);













    method public void setAudioState(android.telecom.AudioState);













    method public void stopDtmfTone();













    method public void swap();













    method public void unhold();













    method public final void unregisterCallback(android.telecom.RemoteConference.Callback);













  }

























  public static abstract class RemoteConference.Callback {













    ctor public RemoteConference.Callback();













    method public void onCapabilitiesChanged(android.telecom.RemoteConference, int);













    method public void onConferenceableConnectionsChanged(android.telecom.RemoteConference, java.util.List<android.telecom.RemoteConnection>);













    method public void onConnectionAdded(android.telecom.RemoteConference, android.telecom.RemoteConnection);













    method public void onConnectionRemoved(android.telecom.RemoteConference, android.telecom.RemoteConnection);













    method public void onDestroyed(android.telecom.RemoteConference);













    method public void onDisconnected(android.telecom.RemoteConference, android.telecom.DisconnectCause);













    method public void onStateChanged(android.telecom.RemoteConference, int, int);













  }

























  public final class RemoteConnection {













    method public void abort();













    method public void answer();













    method public void disconnect();













    method public android.net.Uri getAddress();













    method public int getAddressPresentation();













    method public int getCallCapabilities();













    method public java.lang.CharSequence getCallerDisplayName();













    method public int getCallerDisplayNamePresentation();













    method public android.telecom.RemoteConference getConference();













    method public java.util.List<android.telecom.RemoteConnection> getConferenceableConnections();













    method public android.telecom.DisconnectCause getDisconnectCause();













    method public int getState();













    method public android.telecom.StatusHints getStatusHints();













    method public void hold();













    method public boolean isRingbackRequested();













    method public boolean isVoipAudioMode();













    method public void playDtmfTone(char);













    method public void postDialContinue(boolean);













    method public void registerCallback(android.telecom.RemoteConnection.Callback);













    method public void reject();













    method public void setAudioState(android.telecom.AudioState);













    method public void stopDtmfTone();













    method public void unhold();













    method public void unregisterCallback(android.telecom.RemoteConnection.Callback);













  }

























  public static abstract class RemoteConnection.Callback {













    ctor public RemoteConnection.Callback();













    method public void onAddressChanged(android.telecom.RemoteConnection, android.net.Uri, int);













    method public void onCallCapabilitiesChanged(android.telecom.RemoteConnection, int);













    method public void onCallerDisplayNameChanged(android.telecom.RemoteConnection, java.lang.String, int);













    method public void onConferenceChanged(android.telecom.RemoteConnection, android.telecom.RemoteConference);













    method public void onConferenceableConnectionsChanged(android.telecom.RemoteConnection, java.util.List<android.telecom.RemoteConnection>);













    method public void onDestroyed(android.telecom.RemoteConnection);













    method public void onDisconnected(android.telecom.RemoteConnection, android.telecom.DisconnectCause);













    method public void onPostDialWait(android.telecom.RemoteConnection, java.lang.String);













    method public void onRingbackRequested(android.telecom.RemoteConnection, boolean);













    method public void onStateChanged(android.telecom.RemoteConnection, int);













    method public void onStatusHintsChanged(android.telecom.RemoteConnection, android.telecom.StatusHints);













    method public void onVoipAudioChanged(android.telecom.RemoteConnection, boolean);













  }

























  public final class StatusHints implements android.os.Parcelable {













    ctor public StatusHints(android.content.ComponentName, java.lang.CharSequence, int, android.os.Bundle);













    method public int describeContents();













    method public android.os.Bundle getExtras();













    method public android.graphics.drawable.Drawable getIcon(android.content.Context);













    method public int getIconResId();













    method public java.lang.CharSequence getLabel();













    method public android.content.ComponentName getPackageName();













    method public void writeToParcel(android.os.Parcel, int);













    field public static final android.os.Parcelable.Creator<android.telecom.StatusHints> CREATOR;













  }



























  public class TelecomManager {













    method public void addNewIncomingCall(android.telecom.PhoneAccountHandle, android.os.Bundle);















    method public void cancelMissedCallsNotification();













    method public void clearAccounts();













    method public android.net.Uri getAdnUriForPhoneAccount(android.telecom.PhoneAccountHandle);













    method public android.telecom.PhoneAccountHandle getConnectionManager();













    method public android.telecom.PhoneAccountHandle getDefaultOutgoingPhoneAccount(java.lang.String);













    method public android.telecom.PhoneAccount getPhoneAccount(android.telecom.PhoneAccountHandle);













    method public java.util.List<android.telecom.PhoneAccountHandle> getPhoneAccountsForPackage();













    method public java.util.List<android.telecom.PhoneAccountHandle> getPhoneAccountsSupportingScheme(java.lang.String);















    method public boolean handleMmi(java.lang.String);













    method public boolean handleMmi(android.telecom.PhoneAccountHandle, java.lang.String);













    method public boolean hasMultipleCallCapableAccounts();















    method public boolean isInCall();













    method public void registerPhoneAccount(android.telecom.PhoneAccount);















    method public void showInCallScreen(boolean);













    method public void unregisterPhoneAccount(android.telecom.PhoneAccountHandle);













    field public static final java.lang.String ACTION_CHANGE_PHONE_ACCOUNTS = "android.telecom.action.CHANGE_PHONE_ACCOUNTS";













    field public static final java.lang.String ACTION_CONNECTION_SERVICE_CONFIGURE = "android.telecom.action.CONNECTION_SERVICE_CONFIGURE";















    field public static final java.lang.String ACTION_SHOW_CALL_SETTINGS = "android.telecom.action.SHOW_CALL_SETTINGS";















    field public static final char DTMF_CHARACTER_PAUSE = 44; // 0x002c ','















    field public static final char DTMF_CHARACTER_WAIT = 59; // 0x003b ';'













    field public static final java.lang.String EXTRA_CALL_BACK_NUMBER = "android.telecom.extra.CALL_BACK_NUMBER";















    field public static final java.lang.String EXTRA_CALL_DISCONNECT_CAUSE = "android.telecom.extra.CALL_DISCONNECT_CAUSE";















    field public static final java.lang.String EXTRA_CALL_DISCONNECT_MESSAGE = "android.telecom.extra.CALL_DISCONNECT_MESSAGE";













    field public static final java.lang.String EXTRA_CONNECTION_SERVICE = "android.telecom.extra.CONNECTION_SERVICE";













    field public static final java.lang.String EXTRA_PHONE_ACCOUNT_HANDLE = "android.telecom.extra.PHONE_ACCOUNT_HANDLE";















    field public static final java.lang.String EXTRA_START_CALL_WITH_SPEAKERPHONE = "android.telecom.extra.START_CALL_WITH_SPEAKERPHONE";















    field public static final java.lang.String GATEWAY_ORIGINAL_ADDRESS = "android.telecom.extra.GATEWAY_ORIGINAL_ADDRESS";















    field public static final java.lang.String GATEWAY_PROVIDER_PACKAGE = "android.telecom.extra.GATEWAY_PROVIDER_PACKAGE";

























core/res/AndroidManifest.xml



+11
−6




























Original line number
Diff line number
Diff line








@@ -1269,26 +1269,31 @@













        android:description="@string/permdesc_use_sip"















        android:label="@string/permlab_use_sip" />





























    <!-- Protects the ability to register any PhoneAccount with













    <!-- @SystemApi Protects the ability to register any PhoneAccount with















         PhoneAccount#CAPABILITY_SIM_SUBSCRIPTION. This capability indicates that the PhoneAccount













         corresponds to a device SIM. -->













         corresponds to a device SIM.













         @hide -->















    <permission android:name="android.permission.REGISTER_SIM_SUBSCRIPTION"















        android:permissionGroup="android.permission-group.PHONE_CALLS"















        android:protectionLevel="system|signature"















        android:description="@string/permdesc_register_sim_subscription"















        android:label="@string/permlab_register_sim_subscription" />





























    <!-- Protects the ability to register any PhoneAccount with













         PhoneAccount#CAPABILITY_CALL_PROVIDER. -->













    <!-- @SystemApi Protects the ability to register any PhoneAccount with













         PhoneAccount#CAPABILITY_CALL_PROVIDER.













         @hide -->















    <permission android:name="android.permission.REGISTER_CALL_PROVIDER"















        android:permissionGroup="android.permission-group.PHONE_CALLS"













        android:protectionLevel="system|signature"















        android:description="@string/permdesc_register_call_provider"















        android:label="@string/permlab_register_call_provider" />





























    <!-- Protects the ability to register any PhoneAccount with













         PhoneAccount#CAPABILITY_CONNECTION_MANAGER -->













    <!-- @SystemApi Protects the ability to register any PhoneAccount with













         PhoneAccount#CAPABILITY_CONNECTION_MANAGER













         @hide -->















    <permission android:name="android.permission.REGISTER_CONNECTION_MANAGER"















        android:permissionGroup="android.permission-group.PHONE_CALLS"













        android:protectionLevel="system|signature"















        android:description="@string/permdesc_connection_manager"















        android:label="@string/permlab_connection_manager" />

















































telecomm/java/android/telecom/AudioState.java



+3
−0




























Original line number
Diff line number
Diff line








@@ -16,6 +16,7 @@





























package android.telecom;





























import android.annotation.SystemApi;















import android.os.Parcel;















import android.os.Parcelable;

























@@ -24,7 +25,9 @@ import java.util.Locale;













/**















 *  Encapsulates the telecom audio state, including the current audio routing, supported audio















 *  routing and mute.













 *  @hide















 */













@SystemApi















public final class AudioState implements Parcelable {















    /** Direct the audio stream through the device's earpiece. */















    public static final int ROUTE_EARPIECE      = 0x00000001;

































telecomm/java/android/telecom/Conference.java



+4
−0


























File changed.
Preview size limit exceeded, changes collapsed.
























telecomm/java/android/telecom/Connection.java



+3
−0


























File changed.
Preview size limit exceeded, changes collapsed.