/* * Copyright (C) 2015 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.app; import android.content.ClipData; import android.content.Intent; import android.net.Uri; import android.os.Bundle; import android.os.Parcel; import android.os.Parcelable; /** * Holds information about the content an application is viewing, to hand to an * assistant at the user's request. This is filled in by * {@link android.app.Activity#onProvideAssistContent Activity.onProvideAssistContent}. * @deprecated use {@link android.app.assist.AssistContent}. */ @Deprecated public class AssistContent { private boolean mIsAppProvidedIntent = false; private Intent mIntent; private ClipData mClipData; private Uri mUri; /** * @hide * Key name this data structure is stored in the Bundle generated by * {@link android.app.Activity#onProvideAssistData}. */ public static final String ASSIST_KEY = "android:assist_content"; /** * @hide * Retrieve the framework-generated AssistContent that is stored within * the Bundle filled in by {@link android.app.Activity#onProvideAssistContent}. */ public static android.app.assist.AssistContent getAssistContent(Bundle assistBundle) { return assistBundle.getParcelable(ASSIST_KEY); } public AssistContent() { } /** * @hide * Called by {@link android.app.ActivityThread} to set the default Intent based on * {@link android.app.Activity#getIntent Activity.getIntent}. * *

Automatically populates {@link #mUri} if that Intent is an {@link Intent#ACTION_VIEW} * of a web (http or https scheme) URI.

*/ public void setDefaultIntent(Intent intent) { mIntent = intent; setWebUri(null); if (intent != null && Intent.ACTION_VIEW.equals(intent.getAction())) { Uri uri = intent.getData(); if ("http".equals(uri.getScheme()) || "https".equals(uri.getScheme())) { setWebUri(uri); } } } /** * Sets the Intent associated with the content, describing the current top-level context of * the activity. If this contains a reference to a piece of data related to the activity, * be sure to set {@link Intent#FLAG_GRANT_READ_URI_PERMISSION} so the accessibility * service can access it. */ public void setIntent(Intent intent) { mIsAppProvidedIntent = true; mIntent = intent; } /** * Returns the current {@link #setIntent} if one is set, else the default Intent obtained from * {@link android.app.Activity#getIntent Activity.getIntent}. Can be modified in-place. * @hide */ public Intent getIntent() { return mIntent; } /** * Returns whether or not the current Intent was explicitly provided in * {@link android.app.Activity#onProvideAssistContent Activity.onProvideAssistContent}. If not, * the Intent was automatically set based on * {@link android.app.Activity#getIntent Activity.getIntent}. */ public boolean isAppProvidedIntent() { return mIsAppProvidedIntent; } /** * Optional additional content items that are involved with * the current UI. Access to this content will be granted to the assistant as if you * are sending it through an Intent with {@link Intent#FLAG_GRANT_READ_URI_PERMISSION}. */ public void setClipData(ClipData clip) { mClipData = clip; } /** * Return the current {@link #setClipData}, which you can modify in-place. */ public ClipData getClipData() { return mClipData; } /** * Set a web URI associated with the current data being shown to the user. * This URI could be opened in a web browser, or in the app as an * {@link Intent#ACTION_VIEW} Intent, to show the same data that is currently * being displayed by it. The URI here should be something that is transportable * off the device into other environments to acesss the same data as is currently * being shown in the app; if the app does not have such a representation, it should * leave the null and only report the local intent and clip data. */ public void setWebUri(Uri uri) { mUri = uri; } /** * Return the content's web URI as per {@link #setWebUri(android.net.Uri)}, or null if * there is none. */ public Uri getWebUri() { return mUri; } /** @hide */ public AssistContent(Parcel in) { if (in.readInt() != 0) { mIntent = Intent.CREATOR.createFromParcel(in); } if (in.readInt() != 0) { mClipData = ClipData.CREATOR.createFromParcel(in); } if (in.readInt() != 0) { mUri = Uri.CREATOR.createFromParcel(in); } mIsAppProvidedIntent = in.readInt() == 1; } /** @hide */ public void writeToParcelInternal(Parcel dest, int flags) { if (mIntent != null) { dest.writeInt(1); mIntent.writeToParcel(dest, flags); } else { dest.writeInt(0); } if (mClipData != null) { dest.writeInt(1); mClipData.writeToParcel(dest, flags); } else { dest.writeInt(0); } if (mUri != null) { dest.writeInt(1); mUri.writeToParcel(dest, flags); } else { dest.writeInt(0); } dest.writeInt(mIsAppProvidedIntent ? 1 : 0); } }