スタンドアロンの Wear OS アプリと非スタンドアロンの Wear OS アプリ

Wear OS アプリがスマートフォンから独立して動作し、ユーザーが Android または iOS スマートフォンを利用しなくてもスマートウォッチでタスクを完了できるようにすることをおすすめします。スマートウォッチ アプリがスマートフォンの操作を必要とする場合は、Wear OS アプリを非スタンドアロンとしてマークし、ユーザーがスマートフォン アプリを利用できるようにするための措置を講じる必要があります。

アプリを計画する

Android App Bundle を使用すると、同じアプリ掲載情報の下に、各ユーザーのデバイス設定に合わせて最適化された Android パッケージ キット(APK)を自動的に生成できます。そうすれば、ユーザーはアプリの実行に必要なコードとリソースをダウンロードするだけで済みます。

Google Play ストアで配信するアプリのセットアップについては、Wear OS アプリをパッケージ化して配信するAndroid App Bundle スタートガイドをご覧ください。

新しいアプリの場合は、対象 API レベルを 30 以上にする必要があります。詳しくは、Google Play の対象 API レベルの要件を満たすをご覧ください。targetSdkVersion を API レベル 30(Wear OS 3)に設定すると、アプリが最新のプラットフォーム バージョンで適切に動作することを保証できます。

ネットワーク リクエストと高帯域幅ネットワークへのアクセスについては、Wear OS でのネットワーク アクセスと同期をご覧ください。

アプリを Wear OS アプリとして定義する

アプリの Android マニフェスト ファイルで <uses-feature> タグを定義する必要があります。スマートウォッチ アプリであることを示すため、次のようなエントリを追加します。

  <manifest>
  ...
  <uses-feature android:name="android.hardware.type.watch" />
  ...
  </manifest>
  

アプリをスタンドアロンまたは非スタンドアロンとして指定する

スマートウォッチ アプリは、スタンドアロン アプリまたは非スタンドアロンアプリのいずれかと見なされます。

  • スタンドアロン: コアにスマートフォン アプリを必要としない、完全に独立したアプリ 説明します。[スマートフォンで開く]はプロンプトが受け入れられる場合は、アプリが代わりに ユーザーがコンテンツに依存することなく、ショートリンクや QR コードなどのアプリの機能を完了できる ストリーミングできます
  • 非スタンドアロン: スマートフォンや別のデバイス上のアプリが必要な、依存するアプリ 説明します。このオプションは、ユーザーが簡単にアクセスできない 代わりに、QR コードやショートリンクなどの代替手段を 認証などのアプリのコア機能の実行。

注: スタンドアロン アプリ以外のアプリでも、ユーザーは モバイルアプリの前に Wear OS アプリを追加してください。そのため、Wear OS アプリで 近くにあるハンドヘルド デバイスに必要なコンパニオン アプリがない場合、ユーザーにメッセージを表示 コンパニオン アプリをインストールします。

Google は、アプリの実行中にアプリのスタンドアロン ステータスの正確性を検証します。 あります。この値は、次の日付の Google Play ストア内でのアプリの公開設定に影響します。 テザリングされていないデバイス(ハンドヘルドとペア設定されていない Wear OS デバイスなど) できます。非スタンドアロン アプリ、デベロッパーが間違えているアプリ 「スタンドアロン」として指定: テザリングされていない できます。

Wear OS アプリで、Android マニフェスト ファイルの meta-data 要素 com.google.android.wearable.standalone の値を設定して、アプリがスタンドアロンか非スタンドアロンかを宣言します。

スマートウォッチ アプリが完全に独立したスタンドアロン アプリである場合は、com.google.android.wearable.standalone の値を true に設定して、そのことを Google Play ストアに伝えます。

<application>
...
  <meta-data
    android:name="com.google.android.wearable.standalone"
    android:value="true" />
...
</application>

スマートウォッチ アプリが非スタンドアロンで、コア機能が別のアプリに依存している場合は、com.google.android.wearable.standalone の値を false に設定します。これは、スマートウォッチ アプリが別のデバイスを必要とすることを意味しますが、Google Play ストアでのアプリのプロモーションには影響しません。

注: com.google.android.wearable.standalone の値が false であっても、スマートフォン アプリをインストールする前にスマートウォッチ アプリをインストールすることは可能です。したがって、このページで説明しているように、必要なスマートフォン アプリがコンパニオン スマートフォンにインストールされていないことをスマートウォッチ アプリが検出した場合は、スマートフォン アプリのインストールをユーザーに促してください。

共有コードとデータ ストレージ

Wear OS アプリとスマートフォン アプリでコードを共有できます。たとえば、ネットワーキング用の共通コードを共有ライブラリに含めることができます。

必要に応じて、フォーム ファクタに固有のコードを別のモジュールに含めることもできます。

標準の Android ストレージ API を使用して、スマートフォンと同じように、データをローカルに保存できます。たとえば、SharedPreferences API または Room 永続ライブラリを使用できます。

別のデバイスでアプリを検出する

スマートウォッチ アプリと対応するスマートフォン アプリは、それぞれ相手のアプリが使用可能かどうかを検出できます。

スマートフォン アプリとスマートウォッチ アプリは、CapabilityClient を使用して、ペア設定されたデバイスにそれぞれのプレゼンスをアドバタイズできます。これは、静的または動的に行うことができます。

ユーザーの Wear OS ネットワーク上のノード(スマートフォン、ペア設定されたスマートウォッチ、クラウドなど)にアプリが存在する場合は、CapabilityClient により、他のアプリがそれを検出することが可能になります。詳しくは、アドバタイズ機能をご覧ください。

一方のアプリが他方のアプリを検出できない場合は、該当のデバイスで Google Play ストアの掲載情報を開くようユーザーに求めることができます。これは、コンパニオン スマートフォン アプリのプレゼンスが適切に機能する必要があるスマートウォッチ アプリに適したソリューションです。

一部のスマートフォン(iPhone など)は Google Play ストアをサポートしていないため、デバイスで Google Play ストアが利用可能かどうかを確認する必要があります。

この後のセクションでは、2 つのシナリオにおけるおすすめの方法について説明します。

  • スタンドアロンのスマートウォッチ アプリがスマートフォン アプリを必要とする場合
  • スマートフォン アプリがスタンドアロンのスマートウォッチ アプリを必要とする場合

詳しくは、 Datalayer ヘルパー サンプルをご覧ください。 <ph type="x-smartling-placeholder"></ph> Datalayer ヘルパー ライブラリの一部) Horologist。これらのヘルパーを使用すると、ハンドヘルド デバイスの接続を Wear OS デバイスなどです 詳細情報 詳細については、このモジュールの Wear OS API リファレンス このリファレンスには、 <ph type="x-smartling-placeholder"></ph> PhoneTypeHelper クラスには、 <ph type="x-smartling-placeholder"></ph> getPhoneDeviceType() メソッドを使用すると、 Wear OS アプリで、コンパニオン スマートフォンが Android デバイスか iOS デバイスかを確認します。

アプリの検出に使用する機能の名前を指定する

各デバイスタイプ(スマートウォッチまたはスマートフォン)に対応するアプリで、res/values/wear.xml ファイルに機能名の一意の文字列を指定します。

たとえば、モバイル モジュールでは、wear.xml ファイルに以下の行を含めることができます。

<resources xmlns:tools="http://schemas.android.com/tools"
        tools:keep="@array/android_wear_capabilities">
    <string-array name="android_wear_capabilities">
        <item>verify_remote_example_phone_app</item>
    </string-array>
</resources>

Wear OS モジュールでは、次のように、wear.xml ファイルに機能名の別の値を含めます。

<resources xmlns:tools="http://schemas.android.com/tools"
        tools:keep="@array/android_wear_capabilities">
    <string-array name="android_wear_capabilities">
        <item>verify_remote_example_wear_app</item>
    </string-array>
</resources>

詳しくは、アドバタイズ機能をご覧ください。

アプリの検出とスマートウォッチから URL へのアクセス

スマートウォッチ アプリは、ユーザーのコンパニオン スマートフォンにスマートフォン アプリがインストールされているかどうかを検出できます。手順は次のとおりです。

  1. CapabilityClient を使用して、ペア設定されたスマートフォンにスマートフォン アプリがインストールされているかどうかを確認します。詳しくは、 <ph type="x-smartling-placeholder"></ph> GitHub の datalayer ヘルパー サンプルをご覧ください。
  2. スマートフォン アプリがスマートフォンにインストールされていない場合は、PhoneDeviceType.getPhoneDeviceType() メソッドを使用してスマートフォンのタイプを確認します。詳しくは、次のセクションをご覧ください。
  3. PhoneDeviceType.DEVICE_TYPE_ANDROID が返された場合は、Android スマートフォンです。Wear OS デバイスで RemoteActivityHelper.startRemoteActivity() を呼び出して、スマートフォンで Google Play ストアを開きます。スマートフォン アプリのマーケット URI を使用します。これは、Wear アプリの URI とは異なる場合があります。たとえば、market://details?id=com.example.android.wearable.wear.finddevices のようなマーケット URI を使用します。
  4. PhoneDeviceType.DEVICE_TYPE_IOS が返された場合は、Google Play ストアを利用できない iOS スマートフォンです。Wear デバイスで RemoteActivityHelper.startRemoteActivity() を呼び出して、iPhone で App Store を開きます。アプリの iTunes URL(https://itunes.apple.com/us/app/yourappname など)を指定できます。

    Wear OS から、スマートフォン アプリが iOS デバイスにインストールされているかどうかをプログラムで確認することはできません。App Store を開く操作を手動でトリガーするメカニズムをユーザーに提供することをおすすめします。

: 前述の RemoteActivityHelper API を使用して、スマートウォッチからなんらかの URL をスマートフォンで開く必要があることと、スマートフォン アプリが不要であることを示します。

ペア設定されたスマートフォンのタイプを検出する方法の詳細

getPhoneDeviceType() メソッドを使用して、スマートウォッチがペア設定されているスマートフォンのタイプを確認するスニペットを次に示します。

Kotlin

var phoneDeviceType: Int = PhoneDeviceType.getPhoneDeviceType(context)

Java

int phoneDeviceType = PhoneDeviceType.getPhoneDeviceType(context);

getPhoneDeviceType() メソッドから返される値は以下のいずれかです。

戻り値 説明
DEVICE_TYPE_ANDROID コンパニオン スマートフォンは Android デバイスです。
DEVICE_TYPE_IOS コンパニオン スマートフォンは iOS デバイスです。
DEVICE_TYPE_UNKNOWN コンパニオン スマートフォンは不明なデバイスです。
DEVICE_TYPE_ERROR ペア設定されているスマートフォンのタイプの確認中にエラーが発生したため、後でもう一度確認する必要があります。

アプリの検出を Android スマートフォンから開始する

Android スマートフォンは、ユーザーの Wear OS デバイスにスマートウォッチ アプリがインストールされているかどうかを検出できます。手順は次のとおりです。

  1. NodeClient を使用して、ユーザーのスマートフォンに接続されているスマートウォッチをすべて検出します。詳しくは、 <ph type="x-smartling-placeholder"></ph> GitHub の datalayer ヘルパー サンプルをご覧ください。
  2. CapabilityClient を使用して、ユーザーのどのスマートウォッチにアプリがインストールされているかを確認します。
  3. アプリがインストールされていないスマートウォッチがある場合は、RemoteActivityHelper.startRemoteActivity() メソッドを使用して、ユーザーがスマートフォンから残りの Wear OS デバイスで Google Play ストアを開くことを可能にします。Wear OS アプリのマーケット URI を使用します。これは、スマートフォン アプリの URI とは異なる場合があります。たとえば、market://details?id=com.example.android.wearable.wear.finddevices のようなマーケット URI を使用します。

iPhone とペア設定されているスマートウォッチの位置情報

iPhone とペア設定されているスマートウォッチで位置情報を取得するには、Fused Location Provider(FLP)を使用します。詳しくは、Wear OS 上で位置情報を検出するをご覧ください。

コンパニオン スマートフォンを使用できる場合、FLP はコンパニオン スマートフォンを使用して位置情報を取得します。

必要なデータのみを取得する

一般的に、インターネットからデータを取得する場合は、必要なデータのみを取得します。そうしないと、不必要な遅延、メモリ使用、バッテリーの消耗を招くことがあります。

スマートウォッチが Bluetooth LE で接続されている場合、スマートウォッチによっては、アプリはわずか 4 KB/秒の帯域幅しか使用しない可能性があります。そのため、次の手順を使用することをおすすめします。

  • スマートフォン アプリでのみ必要な追加データについて、ネットワーク リクエストおよびレスポンスを監査する。
  • 大きな画像は、ネットワーク経由でスマートウォッチに送信する前に縮小する。

高帯域幅ネットワークが必要な場合は、高帯域幅ネットワークへのアクセスをご覧ください。

その他のコードサンプル

「 <ph type="x-smartling-placeholder"></ph> Datalayer ヘルパー サンプルでは、このページで説明した API の使用方法について詳しく説明しています。