Advanced

Advanced features of our SDK:

Connect Wallet - Native

The code samples below trigger a wallet connection silently. No UI displays to the user. Your application is responsible for rendering the progress dialog, and for handling errors and allowing the user to cancel the app connect operation.

Unity

// Start connect flow
OVSdk.Sdk.AppConnectManager.ConnectWallet("in-game-user-id");

// Cancel currently active connect flow
OVSdk.Sdk.AppConnectManager.CancelConnect();

Android

// Start connect flow
VesselSdk.getInstance( activity )
         .getAppConnectManager()
         .connectWallet("in-game-user-id");
         
// Cancel currently active connect flow
VesselSdk.getInstance( activity )
         .getAppConnectManager()
         .cancelConnect();Load Balance Deeplink

iOS

// Start connect flow
[[[OVLSdk sharedInstance] appConnectManager] 
    connectWalletWithUserId: @"in-game-user-id"];
         
// Cancel currently active connect flow
[[[OVLSdk sharedInstance] appConnectManager] cancelConnect];

Load Balance Deeplink

Load Balance allows Developer's to deeplink users directly into Vessel and prompt a coin purchase. Developers will use this feature under the circumstance they want a user to purchase an NFT but they do not have the sufficient amount of coins to do so:

Unity

// Deeplink to balance page
OVSdk.Sdk.WalletPresenter.LoadBalanceInWalletApplication(<wallet address>);

// Deeplink to balance page and prompt a specific purchase amount (i.e. - 70 coins)
OVSdk.Sdk.WalletPresenter.LoadBalanceInWalletApplication(<wallet address>, <coinamount>);

Android

// Deeplink to balance page
VesselSdk.getInstance( this ).getWalletPresenter().loadBalanceInWalletApplication( <wallet address>, <activity>);

// Deeplink to balance page and prompt a specific purchase amount (i.e. - 70 coins)
VesselSdk.getInstance( this ).getWalletPresenter().loadBalanceInWalletApplication( <wallet address>, <coinamount>, <activity>);

iOS

// Deeplink to balance page
[OVLSdk.sharedInstance.presentationController loadBalanceInWalletApplication:<wallet address>];

// Deeplink to balance page and prompt a specific purchase amount (i.e. - 70 coins)
[OVLSdk.sharedInstance.presentationController loadBalanceInWalletApplication:<wallet address> byAmount:<coinamount>];

Verify Wallet Address in Vessel Application

Verify wallet address method lets you verify if the wallet address of the user is equal to the one, that he logged with, in the Vessel application. Note, that this method will redirect the user directly to the Vessel application after calling it, or advising him to install Vessel Wallet instead.

Unity

OVSdk.Sdk.WalletPresenter.VerifyWalletAddressInWalletApplication("wallet address");

Android

final VesselSdk sdk = VesselSdk.getInstance(currentActivity);

sdk.getWalletPresenter().verifyWalletAddressInWalletApplication("wallet address", currentActivity);

iOS

[OVLSdk.sharedInstance.presentationController verifyWalletAddressInWalletApplication:@"wallet address"];

Disconnect a Wallet

Utilizing the following method disconnects a User's concurrently connected wallet and wipes the Vessel SDK state:

Unity

OVSdk.Sdk.AppConnectManager.DisconnectCurrentSession();

Android

VesselSdk.getInstance( activity )
         .getAppConnectManager()
         .disconnectCurrentSession()

iOS

[[[OVLSdk sharedInstance] appConnectManager] 
  disconnectCurrentSessionWithResultHandler: ^{
    . . .
}];

Setup custom Load Balance logic

After pressing Load Balance button into your Profile page of your Vessel account in custom tab, Vessel SDK checks if custom presenter was used and overrided method could include your own screen to show available IAP products:

Unity

OVSdk.CustomPresenter.LoadBalancePresenter = ShowLoadBalance;

private void ShowLoadBalance()
{
    // ...
}

Android

final VesselSdk sdk = VesselSdk.getInstance( currentActivity );
sdk.getWalletPresenter().setCustomPresenter( customPresenter );

// Custom Presenter definition
@Override
public boolean showLoadBalance()
{
    // ...
    return true;
}

iOS

OVLSdk.sharedInstance.presentationController.customPresenter = customPresenter;

// Custom Presenter definition
- (void)presentLoadBalance
{
    // ...
}

Set callback methods for handling IAP transactions

In order to follow the state of purchase, please use the next interface methods:

Unity

OVSdk.Sdk.IapManager.PurchaseProduct();

OVSdk.IapManagerCallbacks.OnPurchaseSuccess += PurchaseSuccess;
OVSdk.IapManagerCallbacks.OnPurchaseCancel += PurchaseCancelled; 
OVSdk.IapManagerCallbacks.OnPurchaseFailure += PurchaseFailed; 

public void PurchaseSuccess(OVSdk.SuccessfulPurchase successfulPurchase)
{
    // ...
}
public void PurchaseCancelled(OVSdk.CancelledPurchase cancelledPurchase)
{
    // ...
}
public void PurchaseFailed(OVSdk.FailedPurchase failedPurchase)
{
    // ...
}

Android

final VesselSdk sdk = VesselSdk.getInstance(currentActivity);
sdk.getIapManager().purchaseProduct( productId, currentActivity ).whenComplete( (verificationObject, th) -> {
        if ( th != null )
        {
            final boolean isCancelled = Optional
                    .ofNullable( th.getCause() )
                    .filter( IapException.class::isInstance )
                    .map( IapException.class::cast )
                    .map( e -> e.isCanceled() )
                    .orElse( false );

        if ( isCancelled )
            {
            // handle cancel
            }
        else
            {
            // handle failure
            }
}
        else
            {
                // handle success
            }
        });

iOS

[OVLSdk.sharedInstance.iapManager setDelegate: self
                                    delegateQueue: dispatch_get_main_queue()];

[OVLSdk.sharedInstance.iapManager purchaseProductWithIdentifier:@"product id"];

// Delegate definition
- (void)iapManager:(OVIapManagerDelegateForwarder *)iapManager didCancelPurchaseWithProductIdentifier:(NSString *)productId 
{
    // ...
}

- (void)iapManager:(OVIapManagerDelegateForwarder *)iapManager didFailPurchaseWithProductIdentifier:(NSString *)productId error:(NSError *)error 
{
    // ...
}

- (void)iapManager:(OVIapManagerDelegateForwarder *)iapManager didCompletePurchaseWithProductIdentifier:(NSString *)productId receipt:(NSData *)receipt 
{
    // ...
}