Oracle Cloud Infrastructure - Dokumentation

Oracle-Android-Client-SDK in Ihrer App initialisieren

Hier ist, was Sie über die Initialisierung des Android SDK in Ihrer App wissen müssen.

Initialisieren Sie das Oracle-Android-Client-SDK in der Klasse Application. Unter SDK initialisieren werden die verschiedenen Methoden beschrieben, mit denen Sie das SDK initialisieren können. In der JavaDoc, die im SDK enthalten ist, werden alle verfügbaren Klassen beschrieben.

Wenn Sie eine Verbindung zu einem Kanal herstellen, bei dem die Clientauthentifizierung deaktiviert ist, übergeben Sie false als zweiten Parameter an die Konstruktorfunktion BotsConfiguration.BotsConfigurationBuilder().
import android.app.Application;
import oracle.cloud.bots.mobile.core.Bots;
import oracle.cloud.bots.mobile.core.BotsCallback;
import oracle.cloud.bots.mobile.core.BotsConfiguration;
import oracle.cloud.bots.mobile.core.BotsSDKException;

public class YourApplication extends Application {
    @Override
    public void onCreate() {
        super.onCreate();
        try {
                BotsConfiguration botsConfiguration = new BotsConfiguration.BotsConfigurationBuilder(<SERVER_URI>, false, getApplicationContext()) // Configuration to initialize the SDK
                    .channelId(<CHANNEL_ID>)
                    .userId(<USER_ID>)
                    .build();

                Bots.init(this, botsConfiguration, new BotsCallback() {  // Initialize the SDK
                    @Override
                    public void onSuccess(Response paramResponse) {
                        // Handle init success
                    }
                    @Override
                    public void onFailure(Response paramResponse) {
                        // Handle init failure
                    }
                });
        } catch (BotsSDKException e) {
           // Handle Exceptions thrown by SDK
        }
    }
}

Wenn Sie eine Verbindung zu einem Kanal herstellen, bei dem die Clientauthentifizierung aktiviert ist, müssen Sie einige geringfügige Änderungen vornehmen: Sie müssen true als zweiten Parameter an die Konstruktorfunktion BotsConfiguration.BotsConfigurationBuilder() übergeben und die Eigenschaft authTokenProvider mit der Instanz des Typs AuthenticationTokenProvider festlegen, mit der das JWT-Token generiert und übergeben werden kann.

Die Klasse muss die Schnittstelle AuthenticationTokenProvider implementieren, die dann die Funktion getAuthToken() außer Kraft setzt, um ein JWT-Token zu generieren und zurückzugeben. Die Funktion wird vom SDK verwendet, um immer dann ein neues Token zu generieren, wenn eine neue Verbindung aufgebaut werden muss und das vorhandene Token abgelaufen ist. Beispielcode:
import android.app.Application;
import oracle.cloud.bots.mobile.core.AuthenticationTokenProvider;
import oracle.cloud.bots.mobile.core.Bots;
import oracle.cloud.bots.mobile.core.BotsCallback;
import oracle.cloud.bots.mobile.core.BotsConfiguration;
import oracle.cloud.bots.mobile.core.BotsSDKException;

public class YourApplication extends Application {
    @Override
    public void onCreate() {
        super.onCreate();
        try {
                BotsConfiguration botsConfiguration = new BotsConfiguration.BotsConfigurationBuilder(<SERVER_URI>, true, getApplicationContext()) //  Configuration to initialize the SDK
                    .authTokenProvider(new AuthTokenProvider())
                    .build();

                Bots.init(this, botsConfiguration, new BotsCallback() {  // Initialize the SDK
                    @Override
                    public void onSuccess(Response paramResponse) {
                        // Handle init success
                    }
                    @Override
                    public void onFailure(Response paramResponse) {
                        // Handle init failure
                    }
                });
        } catch (BotsSDKException e) {
           // Handle Exceptions thrown by SDK
        }
    }

    private class AuthTokenProvider implements AuthenticationTokenProvider {
        @Override
        public String getAuthToken() {
            // Generate a new JWT Token and return
        }
    }
}
Zeigen Sie die Benutzeroberfläche an:
import oracle.cloud.bots.mobile.ui.ConversationActivity;
 
...
 
 
ConversationActivity.show(this);