ExecuteAppFunctionRequest


public final class ExecuteAppFunctionRequest
extends Object implements Parcelable

java.lang.Object
   ↳ android.app.appfunctions.ExecuteAppFunctionRequest


A request to execute an app function, provided to AppFunctionManager.executeAppFunction.

Use AppFunctionMetadata to construct a ExecuteAppFunctionRequest that correctly targets an app function.

Summary

Nested classes

class ExecuteAppFunctionRequest.Builder

Builder for ExecuteAppFunctionRequest

Inherited constants

Fields

public static final Creator<ExecuteAppFunctionRequest> CREATOR

Public methods

int describeContents()

Describe the kinds of special objects contained in this Parcelable instance's marshaled representation.

AppFunctionActivityId getActivityId()

Returns the AppFunctionActivityId for this request.

AppInteractionAttribution getAttribution()

Returns the AppInteractionAttribution for the ExecuteAppFunctionRequest.

Bundle getExtras()

Returns the additional values for this function execution request.

String getFunctionIdentifier()

Returns the unique identifier of the app function to be executed.

GenericDocument getParameters()

Returns the function parameters as a key-value GenericDocument.

String getTargetPackageName()

Returns the package name of the app that hosts the app function.

void writeToParcel(Parcel dest, int flags)

Flatten this object in to a Parcel.

Inherited methods

Fields

CREATOR

Added in API level 36
public static final Creator<ExecuteAppFunctionRequest> CREATOR

Public methods

describeContents

Added in API level 36
public int describeContents ()

Describe the kinds of special objects contained in this Parcelable instance's marshaled representation. For example, if the object will include a file descriptor in the output of writeToParcel(Parcel,int), the return value of this method must include the CONTENTS_FILE_DESCRIPTOR bit.

Returns
int a bitmask indicating the set of special object types marshaled by this Parcelable object instance.
Value is either 0 or

getActivityId

Added in API level 37
public AppFunctionActivityId getActivityId ()

Returns the AppFunctionActivityId for this request.

This identifier is used to disambiguate between instances of the same app function running in different activities when the function's AppFunctionMetadata.getScope is AppFunctionMetadata.SCOPE_ACTIVITY.

If this returns null, the request targets an app function that is not AppFunctionMetadata.SCOPE_ACTIVITY.

Returns
AppFunctionActivityId

getAttribution

Added in API level 37
public AppInteractionAttribution getAttribution ()

Returns the AppInteractionAttribution for the ExecuteAppFunctionRequest.

This information can be used by the privacy setting to provide transparency to the user about why an app function was invoked.

Returns
AppInteractionAttribution This value may be null.

getExtras

Added in API level 36
public Bundle getExtras ()

Returns the additional values for this function execution request.

Returns
Bundle This value cannot be null.

getFunctionIdentifier

Added in API level 36
public String getFunctionIdentifier ()

Returns the unique identifier of the app function to be executed.

See AppFunctionMetadata.getName for how to determine this value.

Returns
String This value cannot be null.

getParameters

Added in API level 36
public GenericDocument getParameters ()

Returns the function parameters as a key-value GenericDocument.

The GenericDocument may have missing parameters. Developers are advised to implement defensive handling measures.

Returns
GenericDocument This value cannot be null.

getTargetPackageName

Added in API level 36
public String getTargetPackageName ()

Returns the package name of the app that hosts the app function.

See AppFunctionMetadata.getName for how to determine this value.

Returns
String This value cannot be null.

writeToParcel

Added in API level 36
public void writeToParcel (Parcel dest, 
                int flags)

Flatten this object in to a Parcel.

Parameters
dest Parcel: This value cannot be null.

flags int: Additional flags about how the object should be written. May be 0 or Parcelable.PARCELABLE_WRITE_RETURN_VALUE.
Value is either 0 or a combination of the following: