このガイドでは、カスタム インタラクティビティをカスタムタブに追加する方法について説明します。
デフォルトの共有アクションを有効にする
カスタムの共有アクションを指定しない場合は、オーバーフロー メニューでブラウザのデフォルトの共有アクションを有効にして、表示中のコンテンツへのリンクをユーザーが簡単に共有できるようにすることをおすすめします。
CustomTabsIntent.Builder intentBuilder = new CustomTabsIntent.Builder();
intentBuilder.setShareState(CustomTabsIntent.SHARE_STATE_ON);
カスタム操作ボタンを追加する
重要なアクションのために、カスタムタブ ツールバーを使用して、テキストラベルまたはカスタム アイコン付きのカスタム アクション ボタンを統合できます。アイコンは、高さ 24 dp、幅 24 ～ 48 dp にする必要があります。
たとえば、カスタムの共有アクションをツールバーに追加できます。そのためには、ユーザーがカスタムタブの共有アクションをクリックしたときに呼び出される BroadcastReceiver を作成します。
BroadCastReceiver を AndroidManifest.xml ファイルに登録します。
<application …>
<receiver android:name=".ShareBroadcastReceiver" />
</application>
次に、新しいクラス ShareBroadcastReceiver を追加します。onReceive() メソッドで、現在表示されている URL をインテントから抽出して、送信インテントをトリガーします。
public class ShareBroadcastReceiver extends BroadcastReceiver {
@Override
public void onReceive(Context context, Intent intent) {
String url = intent.getDataString();
Intent sendIntent = new Intent();
sendIntent.setAction(Intent.ACTION_SEND);
sendIntent.putExtra(Intent.EXTRA_TEXT, url);
sendIntent.setType("text/plain");
Intent shareIntent = Intent.createChooser(sendIntent, null);
shareIntent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
context.startActivity(shareIntent);
}
}
次に、ShareBroadcast の PendingIntent を作成し、setActionButton() で登録します。ペンディング インテントを、アイコンと説明とともに渡します。
String shareDescription = getString(R.string.label_action_share);
Bitmap shareIcon = BitmapFactory.decodeResource(getResources(),
android.R.drawable.ic_menu_share);
// Create a PendingIntent to your BroadCastReceiver implementation
Intent actionIntent = new Intent(
this.getApplicationContext(), ShareBroadcastReceiver.class);
PendingIntent pendingIntent =
PendingIntent.getBroadcast(getApplicationContext(), 0 /* request code */, actionIntent, PendingIntent.FLAG_MUTABLE);
//Set the pendingIntent as the action to be performed when the button is clicked.
CustomTabsIntent intentBuilder = new CustomTabsIntent.Builder()
…
.setActionButton(shareIcon, shareDescription, pendingIntent)
.build();
カスタム メニュー項目を追加する
カスタムタブには、ブラウザからデフォルトで最大 5 つの操作（転送、ページ情報、更新、ページ内検索、ブラウザで開く）が用意されています。さらに 7 つまで追加できます。これらのメニュー アイテムは、アイコン行とブラウザが提供するアイテムの間に挿入されます。（下の画像を参照してください）。実際の数は、基になるブラウザの実装によって異なります。（たとえば、Chrome のバージョン 117 では、メニュー項目の数が 5 つから 7 つに増えました）。そのため、最も重要な項目を最初に追加することをおすすめします。
カスタム操作には、右上のその他メニューからアクセスできます。
メニュー項目を追加するには、CustomTabsIntent.Builder.addMenuItem() を呼び出して、タイトルと PendingIntent を指定します。ユーザーがメニュー項目をタップすると、ブラウザは PendingIntent を呼び出します。
CustomTabsIntent intent = new CustomTabsIntent.Builder()
...
.addMenuItem("Menu item 1", pendingIntent)
.addMenuItem("Menu item 2", pendingIntent)
.addMenuItem("Menu item 3", pendingIntent)
.addMenuItem("Menu item 4", pendingIntent)
.addMenuItem("Menu item 5", pendingIntent)
.build();
閉じるボタンをカスタマイズする
カスタムタブをアプリのフローに合わせやすくするには、閉じるボタンをカスタマイズします。カスタムタブがモーダル ダイアログであることをユーザーに感じさせたい場合は、デフォルトの “X” ボタンを使用します。カスタムタブがアプリフローの一部であるとユーザーに感じてほしい場合は、戻る矢印を使用します。
CustomTabsIntent.Builder intentBuilder = new CustomTabsIntent.Builder();
intentBuilder.setCloseButtonIcon(BitmapFactory.decodeResource(
getResources(), R.drawable.ic_arrow_back));
下部のツールバーを追加する
下部のツールバーは、カスタムタブに機能を追加するための非常に柔軟な手段です。
RemoteViews オブジェクトを CustomTabIntent.Builder.setSecondaryToolbarViews() に渡すと、下部のツールバーを完全にカスタマイズして動的に更新できます。
まず、新しいレイアウト ファイル res/layout/custom_tab_toolbar.xml を作成してツールバーのレイアウトを宣言します。
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:orientation="horizontal"
android:gravity="center">
<Button xmlns:android="http://schemas.android.com/apk/res/android"
android:id="@+id/ct_toolbar_next"
android:layout_width="wrap_content"
android:layout_height="48dp"
android:layout_margin="8dp"
android:padding="8dp"
android:paddingStart="16dp"
android:paddingEnd="16dp"
android:text="Next" />
<Button xmlns:android="http://schemas.android.com/apk/res/android"
android:id="@+id/ct_toolbar_previous"
android:layout_width="wrap_content"
android:layout_height="48dp"
android:layout_margin="8dp"
android:padding="8dp"
android:text="Previous" />
</LinearLayout>
次のステップでは、ツールバーの操作を処理する BroadcastReceiver を AndroidManifest.xml ファイルに登録します。
<application …>
<receiver android:name=".CustomTabBottomToolbarBroadcastReceiver" />
</application>
次に、下部のツールバーとのすべてのインタラクションを処理する BroadcastReceiver を実装します。
public class BottomToolbarBroadcastReceiver extends BroadcastReceiver {
@Override
public void onReceive(Context context, Intent intent) {
String url = intent.getDataString();
int remoteViewId = intent.getIntExtra(EXTRA_REMOTEVIEWS_CLICKED_ID, -1);
if (remoteViewId == R.id.ct_toolbar_previous) {
// handle previous
} else if (remoteViewId == R.id.ct_toolbar_next) {
// handle next
}
}
}
最後に、ツールバーを登録します。
// Create the pending intent
Intent actionIntent = new Intent(
this.getApplicationContext(), BottomToolbarBroadcastReceiver.class);
PendingIntent pendingIntent =
PendingIntent.getBroadcast(getApplicationContext(), 0 /* request code */, actionIntent, PendingIntent.FLAG_MUTABLE);
// Pass the toolbar layout to the RemoteViews instance
RemoteViews secondaryToolbarViews = new RemoteViews(getPackageName(), R.layout.custom_tab_toolbar);
// All toolbar buttons
int[] clickableIds = {R.id.ct_toolbar_next, R.id.ct_toolbar_previous};
// Register the bottom toolbar when creating a new custom tab intent
CustomTabsIntent intent = new CustomTabsIntent.Builder()
.setSecondaryToolbarViews(secondaryToolbarViews, clickableIds, toolbarPendingIntent)
.build();
ブックマーク ボタンとダウンロード ボタン
その他メニューのブックマーク ボタンとダウンロード ボタンは、デフォルトで有効になっています。無効にするには、CustomTabsIntent.Builder で次のコードを使用します。
CustomTabsIntent customTabsIntent = new CustomTabsIntent.Builder()
.setBookmarksButtonEnabled(false)
.setDownloadButtonEnabled(false)
.build();
次のトピック: カスタムタブでウェブ コンテンツの読み込みを高速化する方法