RemoteInteractionsManager

STATUS_AVAILABLE

public static final int STATUS_AVAILABLE

Indicates that remote interaction is available.

This indicates that there is a connected device capable to handle the remote interaction.

Constant Value: 3 (0x00000003)

STATUS_TEMPORARILY_UNAVAILABLE

public static final int STATUS_TEMPORARILY_UNAVAILABLE

Indicates that remote interaction is temporarily unavailable.

This indicates that there is a known device capable of handling remote interactions, but that it is not currently connected.

Constant Value: 2 (0x00000002)

STATUS_UNAVAILABLE

public static final int STATUS_UNAVAILABLE

Indicates that remote interaction is unavailable.

This indicates that there is no paired device capable to handle the remote interaction.

Constant Value: 1 (0x00000001)

STATUS_UNKNOWN

public static final int STATUS_UNKNOWN

The remote interaction's availability is unknown.

Constant Value: 0 (0x00000000)

continueActivityOnPhoneWithUnlock

public void continueActivityOnPhoneWithUnlock (String targetPackage, 
                String targetAction, 
                Uri targetUri, 
                List<String> targetCategories, 
                String callerPackage, 
                Executor executor, 
                OutcomeReceiver<Void, Throwable> outcomeReceiver)

Start a Remote Activity on the connected companion phone after unlocking the phone.

This API determines if the request qualifies to unlock the phone and start an activity on it. Qualification is that the caller should be in the foreground, have permission granted. Target intent should be within the same package on the phone, or the target intent is an Intent.ACTION_VIEW action with category Intent.CATEGORY_BROWSABLE with an empty package and the URI starting with "https". If the request qualifies, it sends the request to Companion. Otherwise, the request will be rejected and the result will be returned via OutcomeReceiver. If unlock is not successful, the request will fail and the result will be returned via OutcomeReceiver as well.

Based on the parameters provided, the intent that will be sent to the phone will be constructed as follows:

 Intent remoteIntent = new Intent()
                       .setPackage(targetPackage)
                       .setAction(targetAction)
                       .setData(targetUri);
 for (String category : targetCategories) {
     remoteIntent.addCategory(category);
 }
 

registerContinueActivityOnPhoneWithUnlockStatusListener

public void registerContinueActivityOnPhoneWithUnlockStatusListener (Executor listenerExecutor, 
                Consumer<Integer> listener)

Registers a listener for ContinueActivityOnPhoneWithUnlock's availability status changes. ContinueActivityOnPhoneWithUnlock can then be used to unlock the phone and launch an activity on the paired phone.

Initial availability status will be delivered upon registration once known.
Requires com.google.wear.services.Permissions.SEND_CONTINUE_ACTIVITY_ON_PHONE

registerRemoteActivityHelperStatusListener

public void registerRemoteActivityHelperStatusListener (Executor listenerExecutor, 
                Consumer<Integer> listener)

Registers a listener for RemoteActivityHelper's availability status change. RemoteActivityHelper can be used to open a screen on the phone.

Initial availability status will be delivered upon registration once known.

registerRemoteAuthClientStatusListener

public void registerRemoteAuthClientStatusListener (Executor listenerExecutor, 
                Consumer<Integer> listener)

Registers a listener for RemoteAuthClient's availability status change. RemoteAuthClient can be used to initiate remote authentication on the phone.

Initial availability status will be delivered upon registration once known.

startRemoteActivity

public void startRemoteActivity (Uri dataUri, 
                List<String> additionalCategories, 
                Executor executor, 
                OutcomeReceiver<Void, Throwable> outcomeReceiver)

Starts a Remote Activity on the connected Companion device where the intent action will be set to Intent.ACTION_VIEW.

This API must be called from the foreground. Otherwise, the request will be rejected and an error will be returned via the OutcomeReceiver.

How the intent will be constructed:

 Intent remoteIntent = new Intent(Intent.ACTION_VIEW)
                      .setData(dataUri)
                      .addCategory(Intent.CATEGORY_BROWSABLE);

 if (additionalCategories != null) {
      for (String category : additionalCategories) {
          remoteIntent.addCategory(category);
      }
 }
 

unregisterContinueActivityOnPhoneWithUnlockStatusListener

public void unregisterContinueActivityOnPhoneWithUnlockStatusListener (Consumer<Integer> listener)

Unregisters a listener for ContinueActivityOnPhoneWithUnlock's availability status changes.
Requires com.google.wear.services.Permissions.SEND_CONTINUE_ACTIVITY_ON_PHONE

unregisterRemoteActivityHelperStatusListener

public void unregisterRemoteActivityHelperStatusListener (Consumer<Integer> listener)

Unregisters a listener for RemoteActivityHelper's availability status change.

unregisterRemoteAuthClientStatusListener

public void unregisterRemoteAuthClientStatusListener (Consumer<Integer> listener)

Unregisters a listener for RemoteAuthClient's availability status change.