このページは Cloud Translation API によって翻訳されました。

ユーザーにネットワークスライスのアップセルを提案

5G ネットワークスライシングにより、特定の用途でネットワークパフォーマンスを向上させて対応できますこのガイドでは、アプリがネットワークスライシングアップセルの UX をトリガーする方法について説明しますフローし、ユーザーが購入を決定した場合にプレミアム接続をリクエストします。

UX フローで携帯通信会社を開く通知がユーザーに表示される
ウェブシートから購入を完了できます。 — **図 1.** アップセルの UX フローの例。

プレミアム機能のインテントを宣言する

ネットワーク機能に関するアプリのリクエストに対応するには、アプリマニフェストでその機能をリクエストするインテントを宣言する必要があります。それ以外の場合、ネットワークリクエストは SecurityException のスローに失敗します。

そのためには、アプリで PackageManager.PROPERTY_SELF_CERTIFIED_NETWORK_CAPABILITIES プロパティを AndroidManifest.xml ファイルに指定し、対応する XML を含めます。作成します。

マニフェストファイル内の機能宣言は、次のようになります。

<property android:name="android.net.PROPERTY_SELF_CERTIFIED_NETWORK_CAPABILITIES"
          android:resource="@xml/network_capabilities" />

対応する network_capabilities.xml リソースファイルは次のようになります。

<network-capabilities-declaration> xmlns:android="http://schemas.android.com/apk/res/android">
    <uses-network-capability android:name="NET_CAPABILITY_PRIORITIZE_LATENCY"/>
</network-capabilities-declaration>

ネットワークスライシングアップセルフローをトリガーする

このコードサンプルは、アップセルフローをトリガーし、有料機能を購入しました。

Context mContext;
Network mNetwork;

public void purchasePremiumCapability() {
    TelephonyManager tm = mContext.getSystemService(TelephonyManager.class);
    int capability = TelephonyManager.PREMIUM_CAPABILITY_PRIORITIZE_LATENCY;
    if (tm.isPremiumCapabilityAvailableForPurchase(capability)) {
        tm.purchasePremiumCapability(capability, Runnable::run, new Consumer<Integer>() {
            @Override
            public void accept(Integer result) {
                Log.d("Purchase premium capability result: "
                        + TelephonyManager.convertPurchaseResultToString(result));
                switch (result) {
                    case /* success or already purchased */:
                        requestPremiumCapabilityNetwork();
                        break;
                    case /* temporary failure */:
                        // TODO: wait and retry
                        break;
                    case /* hard failure */:
                        // TODO: handle failure
                        break;
                    default:
                        Log.e("Unknown purchase result: " + result);
                }
            }
        });
    } else {
        Log.e("Premium capability is not available for purchase.");
    }
}

public void requestPremiumCapabilityNetwork() {
    ConnectvityManager cm = mContext.getSystemService(ConnectivityManager.class);
    NetworkRequest request = NetworkRequest.Builder()
            .addCapability(NetworkCapabilities.NET_CAPABILITY_PRIORITIZE_LATENCY)
            .build();
    cm.requestNetwork(request, new NetworkCallback() {
        @Override
        public void onAvailable(Network network) {
            Log.d("Application can now use the network with the premium capability.");
            mNetwork = network;
        }

        @Override
        public void onLost(Network network) {
            Log.d("Premium capability network is no longer available.");
            mNetwork = null;
            // TODO: clean up anything relying on the premium capability network
        }
    });
}

以降のセクションでは、このプロセスの手順をできます。

ステップ 1: プレミアム機能が利用可能かどうかを確認する

呼び出し isPremiumCapabilityAvailableForPurchase() API メソッドを使用して利用可能かどうかを表します。このメソッドは true を返します。アップセルを使用して携帯通信会社から機能を購入できるかどうか。通知ワークフローに進みます

ステップ 2: アップセル通知フローを開始する

プレミアム機能が利用できることを確認したら、アプリは purchasePremiumCapability() アップセル通知フローを開始します。ユーザーがまだ購入していない場合すべての前提条件が満たされている場合、プラットフォームはパフォーマンスブーストオプションを知らせる通知がユーザーに表示されます利用できる場合があります。ユーザーが通知をタップすると、購入プロセスを続行できるように、携帯通信会社の WebView が開きます。

purchasePremiumCapability() に渡される parameter コールバックは、購入リクエストの結果コードを返します

結果コード PURCHASE_PREMIUM_CAPABILITY_RESULT_SUCCESS および PURCHASE_PREMIUM_CAPABILITY_RESULT_ALREADY_PURCHASED 成功した場合は、アプリがリクエストプレミアム機能に限られます。

以下の結果コードは、失敗した購入リクエストを表します。詳しくは、 API リファレンスで詳細をご確認ください

ステップ 3: 購入したプレミアム接続をリクエストする

アップセル通知フローで正常なコードが返された場合（PURCHASE_PREMIUM_CAPABILITY_RESULT_SUCCESS または PURCHASE_PREMIUM_CAPABILITY_RESULT_ALREADY_PURCHASED など）、アプリで使用すべき requestNetwork() 要求された機能を満たすネットワークをリクエストします。注: NetworkRequest オブジェクトを構築する場合、追加する機能は同じではありません。 API に渡す機能TelephonyManager を使用します。次の表は、TelephonyManager クラスの定数を NetworkCapabilities 内の対応する定数。

`TelephonyManager` 定数	`NetworkCapabilities` 定数
`PREMIUM_CAPABILITY_PRIORITIZE_LATENCY`	`NET_CAPABILITY_PRIORITIZE_LATENCY`

購入リクエストが失敗した場合、アプリはデフォルトのリクエストを使用し、それを使用する必要があります。ネットワークを使用してください。プレミアムスライスが新しいスライスの場合は、処理できません。