Android 4.1 API

API レベル: 16

Android 4.1(JELLY_BEAN)は、パフォーマンスの向上とユーザー エクスペリエンスの強化を実現するプラットフォームの進化形です。ユーザーとアプリ デベロッパー向けの新しい機能が追加されています。このドキュメントでは、アプリ デベロッパーにとって特に注目すべき、有用な新しい API の概要を説明します。

アプリ デベロッパーは、Android エミュレータで実行できるシステム イメージとして、またアプリをビルドできる SDK プラットフォームとして、SDK Manager から Android 4.1 を入手できます。Android 4.1 でアプリをビルドしてテストするには、できるだけ早くシステム イメージとプラットフォームをダウンロードする必要があります。

Android 4.1 を搭載したデバイス向けにアプリを最適化するには、targetSdkVersion を "16" に設定し、Android 4.1 システム イメージにインストールしてテストし、この変更を反映したアップデートを公開する必要があります。

Android 4.1 の API を使用しながら、以前のバージョンもサポートするには、minSdkVersion でサポートされていない API を実行する前に、システム API レベルを確認する条件をコードに追加します。下位互換性の維持について詳しくは、下位互換性のある UI の作成をご覧ください。

API レベルの仕組みについて詳しくは、API レベルとはをご覧ください。

アプリ コンポーネント

分離されたサービス

<service> タグで android:isolatedProcess="true" を指定すると、Service は独自の権限を持たない、分離された独自のユーザー ID プロセスの下で実行されます。

メモリ管理

TRIM_MEMORY_RUNNING_LOW や TRIM_MEMORY_RUNNING_CRITICAL などの新しい ComponentCallbacks2 定数により、システムが onLowMemory() を呼び出す前に、フォアグラウンド プロセスにメモリ状態に関する詳細情報が提供されます。

新しい getMyMemoryState(ActivityManager.RunningAppProcessInfo) メソッドを使用すると、一般的なメモリ状態を取得できます。

コンテンツ プロバイダ

新しいメソッド acquireUnstableContentProviderClient() を使用すると、ContentProviderClient にアクセスできます。このメソッドは「不安定」な場合があるため、コンテンツ プロバイダがクラッシュしてもアプリはクラッシュしません。これは、別のアプリでコンテンツ プロバイダを操作する場合に便利です。

ライブ壁紙

ライブ壁紙のプレビュー アクティビティを直接起動する新しいインテント プロトコル。ユーザーは、アプリを離れてホーム壁紙選択ツールに移動することなく、ライブ壁紙を選択できます。

ライブ壁紙選択ツールを起動するには、ACTION_CHANGE_LIVE_WALLPAPER を使用して Intent を指定した startActivity() を呼び出し、EXTRA_LIVE_WALLPAPER_COMPONENT でライブ壁紙 ComponentName を文字列として指定するエクストラを追加します。

アプリスタックのナビゲーション

Android 4.1 では、上への移動に適切なデザイン パターンを簡単に実装できます。必要な作業は、マニフェスト ファイルの各 <activity> 要素に android:parentActivityName を追加することだけです。システムはこの情報を使用して、ユーザーがアクションバーの上ボタンを押したときに適切なアクティビティを開きます(同時に、現在のアクティビティを終了します)。そのため、各アクティビティに android:parentActivityName を宣言すると、アクションバーのアプリアイコンのクリック イベントを処理する onOptionsItemSelected() メソッドは不要になります。システムがそのイベントを処理し、適切なアクティビティを再開または作成するようになります。

これは、ユーザーが通知や別のアプリからのインテントなど、「ディープダイブ」インテントを介してアプリのアクティビティの 1 つに入るシナリオで特に効果的です(アプリ間の移動に関するデザインガイドを参照)。ユーザーがこの方法でアクティビティに入ると、ユーザーが上に移動したときに再開できるアクティビティのバックスタックがアプリに自然に存在しない可能性があります。ただし、アクティビティに android:parentActivityName 属性を指定すると、システムは、アプリに親アクティビティのバックスタックがすでに含まれているかどうかを認識し、含まれていない場合は、すべての親アクティビティを含む合成バックスタックを構築します。

注: ユーザーがアプリ内の深いアクティビティに入り、アプリの新しいタスクが作成されると、システムは親アクティビティのスタックをタスクに挿入します。そのため、戻るボタンを押すと、親アクティビティのスタックを戻ることになります。

システムは、アプリの合成バックスタックを作成するときに、基本的な Intent をビルドして、各親アクティビティの新しいインスタンスを作成します。そのため、ユーザーが各アクティビティを自然に移動した場合に期待されるような、親アクティビティの保存された状態はありません。親アクティビティのいずれかが、通常はユーザーのコンテキストに依存する UI を表示する場合、そのコンテキスト情報は失われるため、ユーザーがスタックを戻るときにそのコンテキスト情報を提供する必要があります。たとえば、ユーザーが音楽アプリでアルバムを表示している場合、上に移動すると、選択した音楽ジャンルのすべてのアルバムを一覧表示するアクティビティに移動します。この場合、スタックを作成する必要がある場合は、現在のアルバムがどのジャンルに属しているかを親アクティビティに通知する必要があります。これにより、ユーザーが実際にそのアクティビティから来たかのように、親アクティビティが適切なリストを表示できるようになります。このような情報を合成親アクティビティに渡すには、onPrepareNavigateUpTaskStack() メソッドをオーバーライドする必要があります。これにより、親アクティビティを合成するためにシステムが作成した TaskStackBuilder オブジェクトが提供されます。TaskStackBuilder には、システムが各親アクティビティの作成に使用する Intent オブジェクトが含まれています。onPrepareNavigateUpTaskStack() の実装では、適切な Intent を変更して、親アクティビティが適切なコンテキストを判断して適切な UI を表示するために使用できる追加データを追加できます。

システムは、TaskStackBuilder を作成するときに、親アクティビティの作成に使用される Intent オブジェクトを、アクティビティ ツリーの上部から論理的な順序で追加します。したがって、内部配列に追加された最後の Intent が、現在のアクティビティの直接の親になります。アクティビティの親の Intent を変更する場合は、まず getIntentCount() で配列の長さを確認し、その値を editIntentAt() に渡します。

アプリの構造がより複雑な場合は、他にもいくつか利用可能な API があり、それらを使用して、上への移動の動作を処理し、合成バックスタックを完全にカスタマイズできます。追加の制御を可能にする API には、次のようなものがあります。

onNavigateUp()
これをオーバーライドして、ユーザーが上ボタンを押したときにカスタム アクションを実行します。
navigateUpTo(Intent)
これを呼び出すと、現在のアクティビティを終了し、指定された Intent で示されるアクティビティに移動します。アクティビティがバックスタックに存在するが、最も近い親ではない場合、現在のアクティビティとインテントで指定されたアクティビティの間にある他のすべてのアクティビティも終了します。
getParentActivityIntent()
これを呼び出して、現在のアクティビティの論理的な親を開始する Intent を取得します。
shouldUpRecreateTask(Intent)
これを呼び出して、上に移動するために合成バックスタックを作成する必要があるかどうかをクエリします。合成スタックを作成する必要がある場合は true を、適切なスタックがすでに存在する場合は false を返します。
finishAffinity()
現在のアクティビティと、現在のアクティビティにチェーンされている同じタスク アフィニティを持つすべての親アクティビティを終了するには、これを呼び出します。onNavigateUp() などのデフォルトの動作をオーバーライドする場合は、上へのナビゲーションで合成バックスタックを作成するときに、このメソッドを呼び出す必要があります。
onCreateNavigateUpTaskStack
合成タスクスタックの作成方法を完全に制御する必要がある場合は、これをオーバーライドします。バックスタックのインテントにデータを追加する場合は、代わりに onPrepareNavigateUpTaskStack() をオーバーライドする必要があります。

ただし、ほとんどのアプリでは、これらの API を使用したり onPrepareNavigateUpTaskStack() を実装したりする必要はなく、各 <activity> 要素に android:parentActivityName を追加することで、正しい動作を実現できます。

マルチメディア

メディア コーデック

MediaCodec クラスを使用すると、メディアのエンコードとデコードを行う低レベルのメディア コーデックにアクセスできます。MediaCodec をインスタンス化するには、createEncoderByType() を呼び出してメディアをエンコードするか、createDecoderByType() を呼び出してメディアをデコードします。これらのメソッドはそれぞれ、エンコードまたはデコードするメディアのタイプ("video/3gpp" や "audio/vorbis" など)の MIME タイプを受け取ります。

MediaCodec のインスタンスを作成したら、configure() を呼び出して、メディア形式やコンテンツが暗号化されているかどうかなどのプロパティを指定できます。

メディアのエンコードとデコードのどちらを行う場合でも、MediaCodec を作成した後のプロセスは同じです。まず、getInputBuffers() を呼び出して入力 ByteBuffer オブジェクトの配列を取得し、getOutputBuffers() を呼び出して出力 ByteBuffer オブジェクトの配列を取得します。

エンコードまたはデコードの準備ができたら、dequeueInputBuffer() を呼び出して、ソースメディアのフィードに使用する ByteBuffer のインデックス位置を(入力バッファの配列から)取得します。ソースメディアを ByteBuffer に入力したら、queueInputBuffer() を呼び出してバッファの所有権を解放します。

出力バッファについても同様に、dequeueOutputBuffer() を呼び出して、結果を受け取る ByteBuffer のインデックス位置を取得します。ByteBuffer からの出力を読み取ったら、releaseOutputBuffer() を呼び出して所有権を解放します。

コーデックで暗号化されたメディアデータを処理するには、通常の queueInputBuffer() ではなく、MediaCrypto API と組み合わせて queueSecureInputBuffer() を呼び出します。

コーデックの使用方法については、MediaCodec のドキュメントをご覧ください。

合図に合わせて音声を録音する

新しいメソッド startRecording() を使用すると、MediaSyncEvent で定義されたキューに基づいて音声録音を開始できます。MediaSyncEvent は、オーディオ セッション(MediaPlayer で定義されたセッションなど)を指定します。このセッションが完了すると、オーディオ レコーダーが録音を開始します。たとえば、この機能を使用して、録音セッションの開始を示すオーディオ トーンを再生し、録音を自動的に開始できます。これにより、トーンと録音の開始を手動で同期する必要がなくなります。

タイミング指定テキスト トラック

MediaPlayer が、インバンドとアウトオブバンドの両方のテキスト トラックを処理するようになりました。 インバンド テキスト トラックは、MP4 または 3GPP メディアソース内のテキスト トラックとして提供されます。帯域外のテキスト トラックは、addTimedTextSource() メソッドを使用して外部テキストソースとして追加できます。すべての外部テキスト トラック ソースが追加されたら、getTrackInfo() を呼び出して、データソース内の利用可能なすべてのトラックの更新されたリストを取得する必要があります。

MediaPlayer で使用するトラックを設定するには、使用するトラックのインデックス位置を使用して selectTrack() を呼び出す必要があります。

テキスト トラックの再生準備が整ったときに通知を受け取るには、MediaPlayer.OnTimedTextListener インターフェースを実装して setOnTimedTextListener() に渡します。

オーディオ エフェクト

AudioEffect クラスは、音声のキャプチャ時に追加の音声前処理タイプをサポートするようになりました。

  • AcousticEchoCanceler を使用した音響エコー キャンセラ(AEC)は、キャプチャされた音声信号から、リモート パーティから受信した信号の寄与を除去します。
  • AutomaticGainControl を使用した自動ゲイン コントロール(AGC)は、キャプチャされた信号の出力を自動的に正規化します。
  • NoiseSuppressor を使用したノイズ サプレッサー(NS)は、キャプチャされた信号からバックグラウンド ノイズを除去します。

これらのプリプロセッサ エフェクトは、AudioEffect サブクラスのいずれかを使用して、AudioRecord でキャプチャされたオーディオに適用できます。

注: すべてのデバイスがこれらのエフェクトをサポートしているとは限りません。そのため、対応するオーディオ エフェクト クラスで isAvailable() を呼び出して、利用可能かどうかを必ず最初に確認する必要があります。

ギャップレス再生

2 つの別々の MediaPlayer オブジェクト間でギャップレス再生を実行できるようになりました。最初の MediaPlayer が終了する前に setNextMediaPlayer() を呼び出すと、Android は最初のプレーヤーが停止した瞬間に 2 番目のプレーヤーを開始しようとします。

メディア ルーター。新しい API の MediaRouter、MediaRouteActionProvider、MediaRouteButton は、メディアを再生する場所を選択するための標準的なメカニズムと UI を提供します。

カメラ

オートフォーカスの動き

新しいインターフェース Camera.AutoFocusMoveCallback を使用すると、オート フォーカスの動きの変化をリッスンできます。インターフェースを setAutoFocusMoveCallback() に登録できます。カメラが連続オートフォーカス モード(FOCUS_MODE_CONTINUOUS_VIDEO または FOCUS_MODE_CONTINUOUS_PICTURE)の場合、onAutoFocusMoving() への呼び出しを受け取ります。これにより、オートフォーカスが動き始めたか、動きを停止したかがわかります。

カメラの音

MediaActionSound クラスには、カメラやその他のメディア アクションによって生成される標準的なサウンドを生成する一連の API が用意されています。カスタムの静止カメラまたはビデオカメラを構築する場合は、これらの API を使用して適切な音を再生する必要があります。

音声を再生するには、MediaActionSound オブジェクトをインスタンス化し、load() を呼び出して目的の音声をプリロードしてから、適切なタイミングで play() を呼び出します。

接続

Android ビーム

Android Beam™ で、Bluetooth 経由での大容量ペイロードの転送がサポートされるようになりました。新しい setBeamPushUris() メソッドまたは新しいコールバック インターフェース NfcAdapter.CreateBeamUrisCallback を使用して転送するデータを定義すると、Android はデータ転送を Bluetooth または別の代替トランスポートに委任して、転送速度を高速化します。これは、画像ファイルや音声ファイルなどの大きなペイロードに特に便利で、デバイス間の目に見えるペア設定は必要ありません。Bluetooth 経由の転送を利用するために、アプリ側で追加の作業を行う必要はありません。

setBeamPushUris() メソッドは、アプリから転送するデータを指定する Uri オブジェクトの配列を受け取ります。または、NfcAdapter.CreateBeamUrisCallback インターフェースを実装し、setBeamPushUrisCallback() を呼び出してアクティビティに指定することもできます。

コールバック インターフェースを使用すると、ユーザーが Android ビームで共有を実行したときに、システムがインターフェースの createBeamUris() メソッドを呼び出すため、共有時に共有する URI を定義できます。これは、共有する URI がアクティビティ内のユーザー コンテキストに応じて変化する場合に便利です。一方、setBeamPushUris() を呼び出す方法は、共有する URI が変化せず、事前に安全に定義できる場合に便利です。

ネットワークサービスの検出

Android 4.1 では、マルチキャスト DNS ベースのサービス ディスカバリのサポートが追加されました。これにより、ローカル ネットワークに登録されているモバイル デバイス、プリンタ、カメラ、メディア プレーヤーなどのピアデバイスが Wi-Fi 経由で提供するサービスを検出して接続できます。

新しいパッケージ android.net.nsd には、ローカル ネットワーク上でサービスをブロードキャストし、ネットワーク上のローカル デバイスを検出して、デバイスに接続するための新しい API が含まれています。

サービスを登録するには、まず NsdServiceInfo オブジェクトを作成し、setServiceName()、setServiceType()、setPort() などのメソッドを使用してサービスのさまざまなプロパティを定義する必要があります。

次に、NsdManager.RegistrationListener を実装し、NsdServiceInfo とともに registerService() に渡す必要があります。

ネットワーク上のサービスを検出するには、NsdManager.DiscoveryListener を実装して discoverServices() に渡します。

NsdManager.DiscoveryListener が検出されたサービスに関するコールバックを受信したら、resolveService() を呼び出してサービスを解決する必要があります。このとき、検出されたサービスに関する情報を含む NsdServiceInfo オブジェクトを受け取る NsdManager.ResolveListener の実装を渡すことで、接続を開始できます。

Wi-Fi P2P サービス ディスカバリ

Android 4.1 では、Wi-Fi P2P API が拡張され、WifiP2pManager での関連付け前のサービス ディスカバリがサポートされるようになりました。これにより、Wi-Fi P2P を使用してサービスごとに付近のデバイスを検出してフィルタリングしてから、デバイスに接続できます。一方、ネットワーク サービス ディスカバリでは、既存の接続済みネットワーク(ローカル Wi-Fi ネットワークなど)でサービスを検出できます。

他のデバイスがアプリを検出して接続できるように、Wi-Fi 経由でアプリをサービスとしてブロードキャストするには、アプリサービスを記述する WifiP2pServiceInfo オブジェクトを指定して addLocalService() を呼び出します。

Wi-Fi 経由で付近のデバイスの検出を開始するには、まず Bonjour と Upnp のどちらを使用して通信するかを決定する必要があります。Bonjour を使用するには、まず でコールバック リスナーをセットアップします。setDnsSdResponseListeners() は WifiP2pManager.DnsSdServiceResponseListener と WifiP2pManager.DnsSdTxtRecordListener の両方を受け取ります。Upnp を使用するには、setUpnpServiceResponseListener() を呼び出します。これは WifiP2pManager.UpnpServiceResponseListener を受け取ります。

ローカル デバイスでサービスの検出を開始する前に、addServiceRequest() を呼び出す必要もあります。このメソッドに渡した WifiP2pManager.ActionListener が成功のコールバックを受け取ると、discoverServices() を呼び出してローカル デバイス上のサービスの検出を開始できます。

ローカル サービスが検出されると、Bonjour または Upnp のどちらを使用するように登録したかに応じて、WifiP2pManager.DnsSdServiceResponseListener または WifiP2pManager.UpnpServiceResponseListener へのコールバックを受け取ります。どちらの場合も、受信したコールバックには、ピアデバイスを表す WifiP2pDevice オブジェクトが含まれます。

ネットワーク使用量

新しいメソッド isActiveNetworkMetered() を使用すると、デバイスが現在従量制課金ネットワークに接続されているかどうかを確認できます。ネットワーク トランザクションを大量に実行する前にこの状態を確認することで、ユーザーに費用がかかる可能性のあるデータ使用量を管理し、トランザクションを今実行するか、後で(デバイスが Wi-Fi に接続されたときなど)実行するかを適切に判断できます。

ユーザー補助

ユーザー補助サービス API

Android 4.1 では、ユーザー補助サービス API のリーチが大幅に拡大されました。AccessibilityEvent、AccessibilityNodeInfo、AccessibilityRecord クラスへの追加により、onGesture() を使用した複雑なジェスチャーやその他の入力イベントなど、より多くの入力イベントをモニタリングして応答するサービスを構築できるようになりました。

ユーザー補助サービスは、performAction と setMovementGranularities を使用して、クリック、スクロール、テキストのステップ実行など、ユーザーに代わってアクションを実行することもできます。performGlobalAction() メソッドを使用すると、サービスで戻る、ホーム、最近使ったアプリを開く、通知などの操作を実行することもできます。

カスタマイズ可能なアプリ ナビゲーション

Android アプリをビルドする際に、findFocus() と focusSearch() を使用してフォーカス可能な要素と入力ウィジェットを見つけ、setAccessibilityFocused() を使用してフォーカスを設定することで、ナビゲーション スキームをカスタマイズできるようになりました。

よりアクセスしやすいウィジェット

新しい android.view.accessibility.AccessibilityNodeProvider クラスを使用すると、複雑なカスタムビューをユーザー補助サービスに公開して、よりアクセスしやすい方法で情報を提示できます。android.view.accessibility.AccessibilityNodeProvider を使用すると、カレンダー グリッドなどの高度なコンテンツを含むユーザー ウィジェットで、ウィジェットのレイアウト構造とは完全に分離された、ユーザー補助サービス用の論理的なセマンティック構造を提示できます。このセマンティック構造により、ユーザー補助サービスは視覚障がいのあるユーザーに、より有用なインタラクション モデルを提供できます。

コピー&ペースト

インテントを使用したコピーと貼り付け

setClipData() メソッドを使用して、ClipData オブジェクトを Intent に関連付けることができるようになりました。これは、複数のドキュメントを共有する場合など、インテントを使用して複数の content: URI を別のアプリに転送する場合に特に便利です。この方法で提供される content: URI は、読み取りまたは書き込みアクセスを提供するインテントのフラグも尊重するため、インテント内の複数の URI へのアクセスを許可できます。ACTION_SEND インテントまたは ACTION_SEND_MULTIPLE インテントを開始すると、インテントで指定された URI が ClipData に自動的に伝播され、レシーバにアクセス権が付与されるようになりました。

HTML と文字列スタイルのサポート

ClipData クラスが、スタイル付きテキスト(HTML または Android のスタイル付き文字列)をサポートするようになりました。newHtmlText() を使用して、HTML スタイルのテキストを ClipData に追加できます。

Renderscript

RenderScript の演算機能が拡張され、次の機能が追加されました。

  • 1 つのスクリプト内で複数のカーネルをサポート。
  • 新しいスクリプト API rsSample で、コンピューティングからフィルタされたサンプラーを使用してアロケーションから読み取ることをサポート。
  • #pragma でのさまざまなレベルの FP 精度のサポート。
  • コンピューティング スクリプトから RS オブジェクトの追加情報をクエリするためのサポート。
  • パフォーマンスを大幅に改善しました。

また、コンピューティング RenderScript に必要な浮動小数点精度を定義するための新しいプラグマも利用できます。これにより、CPU パスで高速ベクトル数学演算などの NEON のような演算を有効にできます。これは、完全な IEEE 754-2008 標準では不可能です。

注: 試験運用版の RenderScript グラフィック エンジンは非推奨になりました。

アニメーション

アクティビティ起動アニメーション

ズーム アニメーションまたは独自のカスタム アニメーションを使用して Activity を起動できるようになりました。目的のアニメーションを指定するには、ActivityOptions API を使用して Bundle を作成し、startActivity() などのアクティビティを開始するメソッドに渡します。

ActivityOptions クラスには、アクティビティが開くときに表示するアニメーションのタイプごとに異なるメソッドが含まれています。

makeScaleUpAnimation()
画面上の指定された開始位置と指定された開始サイズからアクティビティ ウィンドウを拡大するアニメーションを作成します。たとえば、Android 4.1 のホーム画面では、アプリを開くときにこの機能を使用します。
makeThumbnailScaleUpAnimation()
指定された位置と指定されたサムネイル画像から、アクティビティ ウィンドウを拡大するアニメーションを作成します。たとえば、Android 4.1 の [最近使ったアプリ] ウィンドウでは、アプリに戻る際にこのフラグが使用されます。
makeCustomAnimation()
独自のリソースで定義されたアニメーションを作成します。1 つはアクティビティを開く際のアニメーションを定義し、もう 1 つはアクティビティを停止する際のアニメーションを定義します。

時間アニメーター

新しい TimeAnimator は、アニメーションのフレームごとに通知する TimeAnimator.TimeListener を使用したコールバック メカニズムを提供します。この Animator には、再生時間、補間、オブジェクト値の設定はありません。リスナーのコールバックは、合計経過時間や前のフレームからの経過時間など、各フレームの情報を受け取ります。

ユーザー インターフェース

通知

Android 4.1 では、コンテンツ領域が大きく、大きな画像プレビュー、複数の操作ボタン、構成可能な優先度を備えた通知を作成できます。

通知スタイル

新しいメソッド setStyle() を使用すると、通知に 3 つの新しいスタイルのいずれかを指定できます。各スタイルでは、より大きなコンテンツ領域が提供されます。大きなコンテンツ領域のスタイルを指定するには、setStyle() に次のいずれかのオブジェクトを渡します。

Notification.BigPictureStyle
大きな画像が添付された通知。
Notification.BigTextStyle
1 件のメールなど、大量のテキストを含む通知。
Notification.InboxStyle
複数のメールのスニペットなど、文字列のリストを含む通知。
通知の操作

通知メッセージの下部に表示される操作ボタンが、最大 2 つまでサポートされるようになりました。これは、通知が標準スタイルと大きいスタイルのどちらを使用している場合でも同様です。

操作ボタンを追加するには、addAction() を呼び出します。このメソッドは、アイコンのドローアブル リソース、ボタンのテキスト、実行するアクションを定義する PendingIntent の 3 つの引数を取ります。

優先事項

setPriority() で優先度を設定することで、通知の重要度をシステムに示し、リスト内の通知の順序に影響を与えることができるようになりました。これには、Notification クラスの PRIORITY_* 定数で定義された 5 つの優先度レベルのいずれかを渡すことができます。デフォルトは PRIORITY_DEFAULT で、2 段階高く、2 段階低くできます。

優先度の高い通知とは、一般的にユーザーがすぐに返信したいと思うものです。たとえば、新しいインスタント メッセージ、テキスト メッセージ、直近の予定のリマインダーなどです。優先度の低い通知とは、期限切れのカレンダーの予定やアプリ インストール広告などです。

システム UI のコントロール

Android 4.0(Ice Cream Sandwich)では、システム UI 要素の表示を制御する新しいフラグが追加されました。たとえば、システムバーの外観を暗くしたり、ハンドセットで完全に非表示にしたりできます。Android 4.1 では、setSystemUiVisibility() を呼び出して次のフラグを渡すことで、システム UI 要素の外観と、それに関連するアクティビティ レイアウトをさらに制御できるフラグがいくつか追加されています。

SYSTEM_UI_FLAG_FULLSCREEN
重要でないシステム UI(ステータスバーなど)を非表示にします。 アクティビティがオーバーレイ モードでアクションバーを使用している場合(android:windowActionBarOverlay を有効にすることで)、このフラグはアクションバーも非表示にします。非表示と表示の両方で、調整されたアニメーションを使用して非表示にします。
SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN
システム UI 要素が表示されている場合でも、SYSTEM_UI_FLAG_FULLSCREEN を有効にしたときに使用可能な画面領域と同じ領域を使用するようにアクティビティ レイアウトを設定します。レイアウトの一部がシステム UI でオーバーレイされますが、アプリで SYSTEM_UI_FLAG_FULLSCREEN を使用してシステム UI の表示と非表示を頻繁に切り替える場合は、この方法が便利です。システム UI が表示または非表示になるたびに、レイアウトが新しいレイアウト境界に調整されるのを回避できるためです。
SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION
システム UI 要素が表示されている場合でも、SYSTEM_UI_FLAG_HIDE_NAVIGATION(Android 4.0 で追加)を有効にした場合と同じ画面領域を使用するようにアクティビティ レイアウトを設定します。レイアウトの一部がナビゲーション バーによってオーバーレイされますが、アプリが SYSTEM_UI_FLAG_HIDE_NAVIGATION を使用してナビゲーション バーを頻繁に表示 / 非表示にする場合は、ナビゲーション バーが表示 / 非表示になるたびにレイアウトが新しいレイアウト境界に調整されるのを回避できるため、このフラグが役立ちます。
SYSTEM_UI_FLAG_LAYOUT_STABLE
SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN や SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION を使用している場合は、このフラグを追加して、ビューで fitSystemWindows() を呼び出したときに、定義された境界が利用可能な画面スペースと一致するようにすることをおすすめします。つまり、このフラグを設定すると、すべてのシステム UI を非表示にした後でも、システム UI 要素の表示設定が変更されていないかのように fitSystemWindows() が動作します。

その他の関連するシステム UI フラグの詳細については、Android 4.0 で追加されたフラグに関する説明をご覧ください。

リモートビュー

GridLayout と ViewStub がリモート可能なビューになり、アプリ ウィジェットと通知のカスタム レイアウトのレイアウトで使用できるようになりました。

フォント ファミリー

Android 4.1 では、Roboto フォント スタイルのバリエーションがいくつか追加され、合計 10 種類のバリエーションがアプリで使用できるようになりました。アプリで、ライト バリアントとコンデンス バリアントの両方のフルセットにアクセスできるようになりました。

使用可能な Roboto フォント バリアントの完全なセットは次のとおりです。

  • 標準
  • 斜体
  • 太字
  • 太字の斜体
  • ライト
  • Light-italic
  • Condensed Regular
  • Condensed Italic
  • Condensed bold
  • Condensed bold-italic

これらのいずれかを、新しい fontFamily 属性と textStyle 属性を組み合わせて適用できます。

fontFamily でサポートされている値は次のとおりです。

  • "sans-serif": 通常の Roboto
  • "sans-serif-light"(Roboto Light の場合)
  • "sans-serif-condensed"(Roboto Condensed の場合)

textStyle の値 "bold" と "italic" を使用して、太字や斜体を適用できます。両方を適用するには、android:textStyle="bold|italic" のようにします。

Typeface.create() を使用することもできます。例: Typeface.create("sans-serif-light", Typeface.NORMAL)

入力フレームワーク

複数の入力デバイス

新しい InputManager クラスを使用すると、現在接続されている入力デバイスのセットをクエリし、新しいデバイスが追加、変更、削除されたときに通知を受け取るように登録できます。これは、複数のプレーヤーをサポートするゲームを構築していて、接続されているコントローラの数や、コントローラの数に変更があったことを検出する場合に特に便利です。

接続されているすべての入力デバイスをクエリするには、getInputDeviceIds() を呼び出します。これにより、整数の配列が返されます。各整数は、異なる入力デバイスの ID です。次に、getInputDevice() を呼び出して、指定された入力デバイス ID の InputDevice を取得できます。

新しい入力デバイスが接続、変更、切断されたときに通知を受け取るには、InputManager.InputDeviceListener インターフェースを実装し、registerInputDeviceListener() に登録します。

入力コントローラのバイブレーション

接続された入力デバイスに独自のバイブレーション機能がある場合、InputDevice で getVibrator() を呼び出すことで、既存の Vibrator API を使用してそれらのデバイスのバイブレーションを制御できるようになりました。

権限

新しい権限は次のとおりです。

READ_EXTERNAL_STORAGE
外部ストレージへの保護された読み取りアクセス権を付与します。Android 4.1 では、デフォルトですべてのアプリに読み取りアクセス権が付与されています。今後のリリースでは、この権限を使用してアプリが読み取りアクセスを明示的にリクエストする必要があるように変更されます。アプリケーションがすでに書き込みアクセスをリクエストしている場合は、読み取りアクセスも自動的に取得されます。読み取りアクセス制限を有効にする新しい開発者向けオプションが用意されています。デベロッパーは、このオプションを使用して、将来の Android の動作に対してアプリケーションをテストできます。
android.Manifest.permission.READ_USER_DICTIONARY
アプリが単語リストを読み取れるようにします。これは、IME または設定アプリなどの辞書エディタでのみ必要です。
READ_CALL_LOG
着信と発信に関する情報を含むシステムの通話履歴の読み取りをアプリに許可します。
WRITE_CALL_LOG
スマートフォンに保存されているシステムの通話履歴の変更をアプリに許可します
android.Manifest.permission.WRITE_USER_DICTIONARY
ユーザーの単語辞書への書き込みをアプリに許可します。

デバイスの機能

Android 4.1 には、テレビ画面にユーザー インターフェースを表示するための専用デバイス向けの新しい機能宣言 FEATURE_TELEVISION が含まれています。アプリがテレビ インターフェースを必要とすることを宣言するには、マニフェスト ファイルで <uses-feature> 要素を使用してこの機能を宣言します。

<manifest ... >
    <uses-feature android:name="android.hardware.type.television"
                  android:required="true" />
    ...
</manifest>

この機能は、「テレビ」を一般的なリビングルーム向けのテレビ エクスペリエンスとして定義します。つまり、大画面に表示され、ユーザーは離れた場所に座り、入力はタッチやマウス / ポインタ デバイスではなく D-pad のようなものが主流になるのです。