Merge "Add hidden APIs for number blocking which will be used by the system."... (24b2b02c) · Commits · e / os / android_frameworks_base

core/java/android/provider/BlockedNumberContract.java

+94 −0

Original line number	Original line	Diff line number	Diff line
	@@ -223,4 +223,98 @@ public class BlockedNumberContract {
	return res != null && res.getBoolean(RES_CAN_BLOCK_NUMBERS, false);		return res != null && res.getBoolean(RES_CAN_BLOCK_NUMBERS, false);
	}		}

			/**
			* <p>
			* The contract between the blockednumber provider and the system.
			* </p>
			* <p>This is a wrapper over {@link BlockedNumberContract} that also manages the blocking
			* behavior when the user contacts emergency services. See
			* {@link #notifyEmergencyContact(Context)} for details. All methods are protected by
			* {@link android.Manifest.permission#READ_BLOCKED_NUMBERS} and
			* {@link android.Manifest.permission#WRITE_BLOCKED_NUMBERS} appropriately which ensure that
			* only system can access the methods defined here.
			* </p>
			* @hide
			*/
			public static class SystemContract {
			/**
			* A protected broadcast intent action for letting components with
			* {@link android.Manifest.permission#READ_BLOCKED_NUMBERS} know that the block suppressal
			* status as returned by {@link #getBlockSuppressalStatus(Context)} has been updated.
			*/
			public static final String ACTION_BLOCK_SUPPRESSAL_STATE_CHANGED =
			"android.provider.action.BLOCK_SUPPRESSAL_STATE_CHANGED";

			public static final String METHOD_NOTIFY_EMERGENCY_CONTACT = "notify_emergency_contact";

			public static final String METHOD_END_BLOCK_SUPPRESSAL = "end_block_suppressal";

			public static final String METHOD_SHOULD_SYSTEM_BLOCK_NUMBER = "should_system_block_number";

			public static final String METHOD_GET_BLOCK_SUPPRESSAL_STATUS =
			"get_block_suppresal_status";

			public static final String RES_IS_BLOCKING_SUPPRESSED = "blocking_suppressed";

			public static final String RES_BLOCKING_SUPPRESSED_UNTIL_TIMESTAMP =
			"blocking_suppressed_until_timestamp";

			/**
			* Notifies the provider that emergency services were contacted by the user.
			* <p> This results in {@link #shouldSystemBlockNumber} returning {@code false} independent
			* of the contents of the provider for a duration defined by
			* {@link android.telephony.CarrierConfigManager#KEY_DURATION_BLOCKING_DISABLED_AFTER_EMERGENCY_INT}
			* the provider unless {@link #endBlockSuppressal(Context)} is called.
			*/
			public static void notifyEmergencyContact(Context context) {
			context.getContentResolver().call(
			AUTHORITY_URI, METHOD_NOTIFY_EMERGENCY_CONTACT, null, null);
			}

			/**
			* Notifies the provider to disable suppressing blocking. If emergency services were not
			* contacted recently at all, calling this method is a no-op.
			*/
			public static void endBlockSuppressal(Context context) {
			context.getContentResolver().call(
			AUTHORITY_URI, METHOD_END_BLOCK_SUPPRESSAL, null, null);
			}

			/**
			* Returns {@code true} if {@code phoneNumber} is blocked taking
			* {@link #notifyEmergencyContact(Context)} into consideration. If emergency services have
			* not been contacted recently, this method is equivalent to
			* {@link #isBlocked(Context, String)}.
			*/
			public static boolean shouldSystemBlockNumber(Context context, String phoneNumber) {
			final Bundle res = context.getContentResolver().call(
			AUTHORITY_URI, METHOD_SHOULD_SYSTEM_BLOCK_NUMBER, phoneNumber, null);
			return res != null && res.getBoolean(RES_NUMBER_IS_BLOCKED, false);
			}

			public static BlockSuppressalStatus getBlockSuppressalStatus(Context context) {
			final Bundle res = context.getContentResolver().call(
			AUTHORITY_URI, METHOD_GET_BLOCK_SUPPRESSAL_STATUS, null, null);
			return new BlockSuppressalStatus(res.getBoolean(RES_IS_BLOCKING_SUPPRESSED, false),
			res.getLong(RES_BLOCKING_SUPPRESSED_UNTIL_TIMESTAMP, 0));
			}

			/**
			* Represents the current status of {@link #shouldSystemBlockNumber(Context, String)}. If
			* emergency services have been contacted recently, {@link #isSuppressed} is {@code true},
			* and blocking is disabled until the timestamp {@link #untilTimestampMillis}.
			*/
			public static class BlockSuppressalStatus {
			public final boolean isSuppressed;
			/**
			* Timestamp in milliseconds from epoch.
			*/
			public final long untilTimestampMillis;

			BlockSuppressalStatus(boolean isSuppressed, long untilTimestampMillis) {
			this.isSuppressed = isSuppressed;
			this.untilTimestampMillis = untilTimestampMillis;
			}
			}
			}
	}		}