/* * Copyright (C) 2016 The Android Open Source Project * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package android.service.notification; import android.annotation.SystemApi; import android.annotation.TestApi; import android.app.NotificationChannel; import android.os.Bundle; import android.os.Parcel; import android.os.Parcelable; /** * Ranking updates from the Assistant. * @hide */ @SystemApi @TestApi public final class Adjustment implements Parcelable { private final String mPackage; private final String mKey; private final CharSequence mExplanation; private final Bundle mSignals; private final int mUser; /** * Data type: ArrayList of {@code String}, where each is a representation of a * {@link android.provider.ContactsContract.Contacts#CONTENT_LOOKUP_URI}. * See {@link android.app.Notification.Builder#addPerson(String)}. */ public static final String KEY_PEOPLE = "key_people"; /** * Parcelable {@code ArrayList} of {@link SnoozeCriterion}. These criteria may be visible to * users. If a user chooses to snooze a notification until one of these criterion, the * assistant will be notified via * {@link NotificationAssistantService#onNotificationSnoozedUntilContext}. */ public static final String KEY_SNOOZE_CRITERIA = "key_snooze_criteria"; /** * Create a notification adjustment. * * @param pkg The package of the notification. * @param key The notification key. * @param signals A bundle of signals that should inform notification display, ordering, and * interruptiveness. * @param explanation A human-readable justification for the adjustment. */ public Adjustment(String pkg, String key, Bundle signals, CharSequence explanation, int user) { mPackage = pkg; mKey = key; mSignals = signals; mExplanation = explanation; mUser = user; } protected Adjustment(Parcel in) { if (in.readInt() == 1) { mPackage = in.readString(); } else { mPackage = null; } if (in.readInt() == 1) { mKey = in.readString(); } else { mKey = null; } if (in.readInt() == 1) { mExplanation = in.readCharSequence(); } else { mExplanation = null; } mSignals = in.readBundle(); mUser = in.readInt(); } public static final Creator CREATOR = new Creator() { @Override public Adjustment createFromParcel(Parcel in) { return new Adjustment(in); } @Override public Adjustment[] newArray(int size) { return new Adjustment[size]; } }; public String getPackage() { return mPackage; } public String getKey() { return mKey; } public CharSequence getExplanation() { return mExplanation; } public Bundle getSignals() { return mSignals; } public int getUser() { return mUser; } @Override public int describeContents() { return 0; } @Override public void writeToParcel(Parcel dest, int flags) { if (mPackage != null) { dest.writeInt(1); dest.writeString(mPackage); } else { dest.writeInt(0); } if (mKey != null) { dest.writeInt(1); dest.writeString(mKey); } else { dest.writeInt(0); } if (mExplanation != null) { dest.writeInt(1); dest.writeCharSequence(mExplanation); } else { dest.writeInt(0); } dest.writeBundle(mSignals); dest.writeInt(mUser); } }