これらの文字列をローカライズするには、キーを使用して、アプリケーション・リソースのres/values-<your-language-code>/strings.xmlファイルにある<string>要素のname属性を定義します。たとえば、チャット・ビューのタイトルを英語でローカライズするには、res/value-en/strings.xmlというファイルで次を定義します:

<resources>
    <string name="odaas_bot_chat_title">Support</string>
</resources>

タイトルをフランス語でローカライズするには、res/value-fr/strings.xmlというファイルに次を追加します:

<resources>
    <string name="odaas_bot_chat_title">Soutien</string>
</resources>

res/value/strings.xmlの値は、デフォルトで、res/values-<your-language-code>/strings.xmlで見つからないキーに対して使用されます。これらの2つの例では、res/value-fr/strings.xmlまたはres/value-en/strings.xmlファイルに定義されていないリソースに対して、デフォルト値が使用されます。

パラメータ:

• application – アプリケーション・インスタンス。これはnullにできません。
• botsConfiguration – ライブラリの機能の制御に使用されるBotsConfigurationオブジェクト。これはnullにできません。

Bots.init(getApplication(),
      botsConfiguration);

パラメータ:

• application – アプリケーション・インスタンス。これはnullにできません。
• botsConfiguration – ライブラリの機能の制御に使用されるBotsConfigurationオブジェクト。これはnullにできません。
• botsCallback – 接続の確立中に受信されたコールバック。

Bots.init(getApplication(), botsConfiguration, new BotsCallback() {
    @Override
    public void onSuccess(Response paramResponse) {}
 
    @Override
    public void onFailure(Response paramResponse) {}
});

パラメータ:

• application – アプリケーション・インスタンス。これはnullにできません。
• chatServerUrl – Oracle Chat ServerのURL。これはnullにできません。
• channelId – スキルまたはデジタル・アシスタントにルーティングされるOracle Androidチャネルに属するチャネルID。これはnullにできません。
• userId – ユーザーの一意の識別子。この値が指定されていない場合、SDKによって初期化されます。
• botsCallback – Oracle Chat Serverへの接続の確立中に受信されたコールバック。

Bots.init(getApplication(), chatServerUrl, authTokenProvider, new BotsCallback() {
    @Override
    public void onSuccess(Response paramResponse) {}
 
    @Override
    public void onFailure(Response paramResponse) {}
});

パラメータ:

• application – アプリケーション・インスタンス。これはnullにできません。
• chatServerUrl – Oracle Chat ServerのURL。これはnullにできません。
• authTokenProvider – AuthenticationTokenProviderのインスタンス。必要に応じて認証トークンを生成するために使用します。
• botsCallback – 接続の確立中に受信されたコールバック。

BotsConfiguration botsConfiguration = new BotsConfiguration.BotsConfigurationBuilder(<SERVER_URI>, getApplicationContext())

このインタフェースのインスタンスをauthTokenProviderプロパティに渡すことで、認証されたチャネル接続を確立するために新しい認証トークンが必要になった場合にSDKで生成できます。このインタフェースを実装する場合、public String getAuthTokenメソッドをオーバーライドします。

private class AuthTokenProvider implements AuthenticationTokenProvider {
    @Override
    public String getAuthToken() {
        // Generate a new JWT Token and return
    }
}

このインタフェースは、ライブラリの初期化中にコールバックとして機能します。

• void onSuccess(Response paramResponse) – このメソッドは、Webソケット接続が正常に確立されたときにコールされます。
• void onFailure(Response paramResponse) – このメソッドは、ライブラリの初期化中に障害が発生したときにコールされます。

SDKを初期化した後、public static void show(Context context)を起動して会話ビューを表示します。このメソッドのcontextパラメータは、アクティビティの開始元のコンテキストです。

ConversationActivity.show(getApplicationContext())

NotificationCustomizerクラスをインスタンス化し、インスタンスをnotificationCustomizerプロパティに渡すことで、スキルのメッセージに対して受信された通知をカスタマイズできます。コンストラクタは:

• NotificationCustomizer() – デフォルト構成で通知チャネルを初期化します。
• NotificationCustomizer(String channelId) – 指定されたチャネルIDで通知チャネルを初期化します。channelIdパラメータは、通知が送信される通知チャネルのIDです。
• NotificationCustomizer(String channelId, String channelName, String description, String title) – 指定されたパラメータで通知チャネルを初期化します:

  • channelID – 通知が送信される通知チャネルのID。
  • channelName – 通知が送信される通知チャネルの名前。
  • description – 通知が送信される通知チャネルの説明。
  • title – 通知に表示されるタイトル。

例:

new BotsConfiguration.NotificationCustomizer(<NOTIFICATION_CHANNEL_ID>,
    <NOTIFICATION_CHANNEL_NAME>, <NOTIFICATION_CHANNEL_DESCRIPTION>, <NOTIFICATION_TITLE>);