Deeplink API¶
Introduction¶
The Deeplink APIs allows you to launch the app you want or go to store instead if the user does not buy or install the content.
Note
Deeplink APIs are only supported on Unity engine on Android platform . And will support on PC platform later.
Function Spec¶
-
void GoToApp(StatusCallback2 callback, string viveportId, string launchData)
The API will go to the content of the VIVEPORT ID from the parameter.
API parameters:
| Name | Type | Description |
|---|---|---|
| callback | StatusCallback2 | callback function |
| viveportId | string | VIVEPORT ID of content |
| launchData | string | launch parameter |
-
void GoToStore(StatusCallback2 callback, string viveportId)
The API will go to the store detail page by the content’s VIVEPORT ID whether the user does not buy or install it.
API parameters:
| Name | Type | Description |
|---|---|---|
| callback | StatusCallback2 | callback function |
| viveportId | string | VIVEPORT ID of content |
-
void GoToAppOrGoToStore(StatusCallback2 callback, string viveportId, string launchData)
The API will combine the features of above two APIs. It will automatically detect whether the user buys or installs the content, then launch this content or go to the store detail page.
API parameters:
| Name | Type | Description |
|---|---|---|
| callback | StatusCallback2 | callback function |
| viveportId | string | VIVEPORT ID of content |
-
string GetAppLaunchData()
The launch data input in the parameter of GoToApp can be gotton through the API. It can be used in specific level of the content.
API Return: string
| Type | Description |
|---|---|
| string | the parameter of launchData input in the GoToApp API |
Details¶
How to get a VIVEPORT ID and VIVEPORT key
Please correctly paste the VIVEPORT ID and VIVEPORT KEY of the content into your code snipped through Copy VIVEPORT ID and Copy VIVEPORT KEY buttons on the Manage -> VIVEPORT Listing page of developer console.
Error code¶
| Error Code | Description & Trouble Shooting |
|---|---|
| 0 | Success, no error |
| 50001 | Invalid account id/VIVEPORT id/VIVEPORT key |
| 50004 | Cannot connect to server |
| 60300 | Content is not installed |
| 60310 | VIVEPORT ID doesn’t exist or the internet was diconnected |
| 80002 | GetLicense is failed because user does not login VIVEPORT |
Best Practice¶
Attention
- To get VIVEPORT ID and VIVEPORT Key correctly from the VIVEPORT developer console.
- To use Top Level API -
Viveport.Api.Initto initialize VIVEPORT platform. For Unity developer, it is usually used in MonoBehaviour “Start()”. - To use DRM API -
Viveport.Api.GetLicenseto verify whether current user is allowed to launch the content. It is usually used in where to check the user’s authentication. Show an error message and close the content if getting the error code from the API. - To use Deeplink API -
Viveport.Deeplink.GoToAppto directly launch the content by using the VIVEPORT ID assigned. - To use Deeplink API -
Viveport.Deeplink.GoToStoreto go to the store detail page to remind user to buy / install the content. - To use Deeplink API -
Viveport.Deeplink.GoToAppOrGoToStoreto decide the API is going to launch content or going to store depending on the user’s purchase status. - To use Deeplink API -
Viveport.Deeplink.GetAppLaunchDatato get the launch data that can be used to switch level or something while content is launching. - To use Top Level API -
Viveport.Api.Shutdownto shutdown and release VIVEPORT SDK resources. For Unity developer, it is usually used in MonoBehaviour “OnDestroy()” or before Application.Quit(). - The API will launch current installed APP if the contents are in the production and beta environment at the same time.
Before testing¶
Go to VIVEPORT website and download VIVEPORT desktop application.
Install the downloaded file
ViveportSetup.exeand follow the step by step to complete the setup process.On the PC desktop, a VIVEPORT icon will be there. Double click to launch it and sign in as your developer account.
Important
You could also see the Error Codes and Trouble Shooting pages to know what to do when you got problems using the VIVEPORT SDK.
Notes¶
For Wave content
- In AndroidManifest.xml , declaring a <uses-permission android:name=”com.viveport.CONTENT_SERVICE” /> element as a child of <manifest> .
Example:
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android" ...">
<... />
<uses-permission android:name="com.viveport.CONTENT_SERVICE" />
<... />
</manifest>