Merge "TelephonyRegistryManager API review changes" into main

  @FlaggedApi("com.android.server.telecom.flags.telecom_resolve_hidden_dependencies") public class TelephonyRegistryManager {

    method @RequiresPermission(android.Manifest.permission.MODIFY_PHONE_STATE) public void notifyCallStateChangedForAllSubscriptions(int, @Nullable String);

    method public void notifyOutgoingEmergencyCall(int, int, @NonNull android.telephony.emergency.EmergencyNumber);

    method @RequiresPermission(android.Manifest.permission.MODIFY_PHONE_STATE) public void notifyOutgoingEmergencyCall(int, int, @NonNull android.telephony.emergency.EmergencyNumber);

  }

  public final class ThermalMitigationRequest implements android.os.Parcelable {

import android.annotation.FlaggedApi;

import android.annotation.NonNull;

import android.annotation.Nullable;

import android.annotation.RequiresFeature;

import android.annotation.RequiresPermission;

import android.annotation.SystemApi;

import android.annotation.SystemService;

import android.compat.Compatibility;

import android.compat.annotation.ChangeId;

import android.compat.annotation.EnabledAfter;

import android.content.Context;

import android.content.pm.PackageManager;

import android.os.Binder;

import android.os.Build;

import android.os.RemoteException;

 * Limit API access to only carrier apps with certain permissions or apps running on

 * privileged UID.

 *

 * TelephonyRegistryManager is intended for use on devices that implement

 * {@link android.content.pm.PackageManager#FEATURE_TELEPHONY FEATURE_TELEPHONY}. On devices

 * that do not implement this feature, the behavior is not reliable.

 *

 * @hide

 */

@SystemApi

@SystemService(Context.TELEPHONY_REGISTRY_SERVICE)

@RequiresFeature(PackageManager.FEATURE_TELEPHONY)

@FlaggedApi(Flags.FLAG_TELECOM_RESOLVE_HIDDEN_DEPENDENCIES)

public class TelephonyRegistryManager {

    }

    /**

     * Notify call state changed on all subscriptions.

     * Notify call state changed on all subscriptions, excluding over-the-top VOIP calls (otherwise

     * known as self-managed calls in the Android Platform).

     *

     * @param state latest call state. e.g, offhook, ringing

     * @param incomingNumber incoming phone number.

     * @param incomingNumber incoming phone number or null in the case for OTT VOIP calls

     * @hide

     */

    @SystemApi

    }

    /**

     * Notify outgoing emergency call.

     * Notify outgoing emergency call to all applications that have registered a listener

     * ({@link PhoneStateListener}) or a callback ({@link TelephonyCallback}) to monitor changes in

     * telephony states.

     * @param simSlotIndex Sender phone ID.

     * @param subId Sender subscription ID.

     * @param subscriptionId Sender subscription ID.

     * @param emergencyNumber Emergency number.

     * @hide

     */

    @SystemApi

    public void notifyOutgoingEmergencyCall(int simSlotIndex, int subId,

    @RequiresPermission(android.Manifest.permission.MODIFY_PHONE_STATE)

    public void notifyOutgoingEmergencyCall(int simSlotIndex, int subscriptionId,

            @NonNull EmergencyNumber emergencyNumber) {

        try {

            sRegistry.notifyOutgoingEmergencyCall(simSlotIndex, subId, emergencyNumber);

            sRegistry.notifyOutgoingEmergencyCall(simSlotIndex, subscriptionId, emergencyNumber);

        } catch (RemoteException ex) {

            // system process is dead

            throw ex.rethrowFromSystemServer();