SliceManager

CATEGORY_SLICE

public static final String CATEGORY_SLICE

Category used to resolve intents that can be rendered as slices.

This category should be included on intent filters on providers that extend SliceProvider.

Constant Value: "android.app.slice.category.SLICE"

SLICE_METADATA_KEY

public static final String SLICE_METADATA_KEY

The meta-data key that allows an activity to easily be linked directly to a slice.

An activity can be statically linked to a slice uri by including a meta-data item for this key that contains a valid slice uri for the same application declaring the activity.

 <activity android:name="com.example.mypkg.MyActivity">
     <meta-data android:name="android.metadata.SLICE_URI"
                android:value="content://com.example.mypkg/main_slice" />
  </activity>
 

Constant Value: "android.metadata.SLICE_URI"

bindSlice

public Slice bindSlice (Uri uri, 
                Set<SliceSpec> supportedSpecs)

Turns a slice Uri into slice content.

bindSlice

public Slice bindSlice (Intent intent, 
                Set<SliceSpec> supportedSpecs)

Turns a slice intent into slice content. Is a shortcut to perform the action of both mapIntentToUri(android.content.Intent) and bindSlice(android.net.Uri, java.util.Set) at once.

checkSlicePermission

public int checkSlicePermission (Uri uri, 
                int pid, 
                int uid)

Determine whether a particular process and user ID has been granted permission to access a specific slice URI.

getPinnedSlices

public List<Uri> getPinnedSlices ()

Get the list of currently pinned slices for this app.

getPinnedSpecs

public Set<SliceSpec> getPinnedSpecs (Uri uri)

Get the current set of specs for a pinned slice.

This is the set of specs supported for a specific pinned slice. It will take into account all clients and returns only specs supported by all.

getSliceDescendants

public Collection<Uri> getSliceDescendants (Uri uri)

Obtains a list of slices that are descendants of the specified Uri.

Not all slice providers will implement this functionality, in which case, an empty collection will be returned.
This method may take several seconds to complete, so it should only be called from a worker thread.

grantSlicePermission

public void grantSlicePermission (String toPackage, 
                Uri uri)

Grant permission to access a specific slice Uri to another package.

mapIntentToUri

public Uri mapIntentToUri (Intent intent)

Turns a slice intent into a slice uri. Expects an explicit intent.

This goes through a several stage resolution process to determine if any slice can represent this intent.

1. If the intent contains data that ContentResolver#getType is SliceProvider#SLICE_TYPE then the data will be returned.
2. If the intent explicitly points at an activity, and that activity has meta-data for key SLICE_METADATA_KEY, then the Uri specified there will be returned.
3. Lastly, if the intent with CATEGORY_SLICE added resolves to a provider, then the provider will be asked to SliceProvider#onMapIntentToUri and that result will be returned.
4. If no slice is found, then null is returned.

pinSlice

public void pinSlice (Uri uri, 
                Set<SliceSpec> specs)

Ensures that a slice is in a pinned state.

Pinned state is not persisted across reboots, so apps are expected to re-pin any slices they still care about after a reboot.

This may only be called by apps that are the default launcher for the device or the default voice interaction service. Otherwise will throw SecurityException.

revokeSlicePermission

public void revokeSlicePermission (String toPackage, 
                Uri uri)

Remove permissions to access a particular content provider Uri that were previously added with grantSlicePermission(String, Uri) for a specific target package. The given Uri will match all previously granted Uris that are the same or a sub-path of the given Uri. That is, revoking "content://foo/target" will revoke both "content://foo/target" and "content://foo/target/sub", but not "content://foo". It will not remove any prefix grants that exist at a higher level.

unpinSlice

public void unpinSlice (Uri uri)

Remove a pin for a slice.

If the slice has no other pins/callbacks then the slice will be unpinned.

This may only be called by apps that are the default launcher for the device or the default voice interaction service. Otherwise will throw SecurityException.