Google.Play.Instant.InstallLauncher

Provides methods that an instant app can use to display a Play Store install dialog.

Summary

This dialog will allow the user to install the current instant app as a full app.

Example code for the instant app's install button click handler: const int requestCode = 123; using (var activity = InstallLauncher.GetCurrentActivity()) using (var postInstallIntent = InstallLauncher.CreatePostInstallIntent(activity)) { InstallLauncher.PutPostInstallIntentStringExtra(postInstallIntent, "payload", "test"); InstallLauncher.ShowInstallPrompt(activity, requestCode, postInstallIntent, "referrer"); }

Example code for the installed app to retrieve the result: string payload = InstallLauncher.GetPostInstallIntentStringExtra("payload");

This is a C# implementation of the Java showInstallPrompt() method available in Google Play Services' InstantApps class.

Public static functions
`CreatePostInstallIntent(AndroidJavaObject activity)`	`AndroidJavaObject` Creates an Intent for the Play Store to launch after installing the app.
`GetPostInstallIntentStringExtra(string extraKey)`	`string` This method can be called from an installed app to obtain a string that was included in the postInstallIntent provided by an instant app via ShowInstallPrompt().
`PutPostInstallIntentStringExtra(AndroidJavaObject postInstallIntent, string extraKey, string extraValue)`	`void` This method can be called with the Intent obtained from CreatePostInstallIntent to add a string extra that will be passed through to the installed app.
`ShowInstallPrompt(string referrer)`	`void` Shows a dialog that allows the user to install the current instant app.
`ShowInstallPrompt(AndroidJavaObject activity, int requestCode, AndroidJavaObject postInstallIntent, string referrer)`	`void` Shows a dialog that allows the user to install the current instant app.

Public static functions

CreatePostInstallIntent

AndroidJavaObject CreatePostInstallIntent(
  AndroidJavaObject activity
)

Creates an Intent for the Play Store to launch after installing the app.

It will launch the specified activity. This Intent can be extended to contain additional extras for passing to the installed app. This object should be disposed after use.

Details
Returns	A wrapped Intent object. The AndroidJavaObject should be disposed.

GetPostInstallIntentStringExtra

string GetPostInstallIntentStringExtra(
  string extraKey
)

This method can be called from an installed app to obtain a string that was included in the postInstallIntent provided by an instant app via ShowInstallPrompt().

It assumes that the current activity was the one that was launched by Play Store.

Details

Parameters

extraKey

Key for obtaining a string extra from current activity's intent.

Returns

The string extra value.

PutPostInstallIntentStringExtra

void PutPostInstallIntentStringExtra(
  AndroidJavaObject postInstallIntent,
  string extraKey,
  string extraValue
)

This method can be called with the Intent obtained from CreatePostInstallIntent to add a string extra that will be passed through to the installed app.

Details

Parameters

`postInstallIntent`	An Intent obtained from CreatePostInstallIntent.
`extraKey`	Key for a string extra to add to the post install intent.
`extraValue`	Value for a string extra to add to the post install intent.

ShowInstallPrompt

void ShowInstallPrompt(
  string referrer
)

Shows a dialog that allows the user to install the current instant app.

Details

Parameters

referrer

Optional install referrer string.

ShowInstallPrompt

void ShowInstallPrompt(
  AndroidJavaObject activity,
  int requestCode,
  AndroidJavaObject postInstallIntent,
  string referrer
)

Shows a dialog that allows the user to install the current instant app.

This method is a no-op if the current running process is an installed app. A post-install intent must be provided, which will be used to start the application after install is complete.

Details

Parameters

`activity`	The activity that should launch the store's install dialog.
`requestCode`	The requestCode referenced in the onActivityResult() callback to the activity. Extend UnityPlayerActivity and check for the specified requestCode integer to know whether the dialog was cancelled. Use UnityPlayer.UnitySendMessage() to relay the response from Java back to Unity scripts.
`postInstallIntent`	The intent to launch after the instant app has been installed. Must resolve to an activity in the installed app package, or it will not be used.
`referrer`	Optional install referrer string.

Exceptions

ArgumentNullException

If either activity or postInstallIntent are null.