Windows向けトラブルシューティングインデックス
Windows向けトラブルシューティングインデックス
Windows 11デバイスをサポート対象とするアプリに問題が発生した場合は、このページを使用して考えられる解決策を探してください。新しいアプリの作成に際しては、Windows互換性ガイドのガイダンスとベストプラクティスを参照してください。
ヒント： 動作ではなく、問題が発生しているオブジェクトから調べてみてください。たとえば、ボタン（button）が応答しない（unresponsive）問題については、「U」ではなく「B」の項目を参照します。
注： Windows 11デバイスをサポート対象にするには、Androidアプリを申請する必要があります。モバイルウェブアプリでは、Amazon以外のAndroidデバイスやAndroid用Windowsサブシステムをサポート対象にすることはできません。
A
- 加速度計（accelerometer）機能が動作しない
- 原因： 加速度計機能は、Android用Windowsサブシステムでは現在サポートされていません。
- 解決策： サポートされていないハードウェア機能およびソフトウェア機能については、次のガイドラインに従います。
- アプリのマニフェストの
uses-feature宣言にandroid: required="false"を追加します。 - アプリの機能を無効にします。モバイルアプリに同じAPKを使用している場合は、条件付きロジックを使用して、Android用Windowsサブシステムでサポートされていない機能を無効にします。
- アプリのマニフェストの
- アクセシビリティ（accessibility）機能が動作しない
- 原因： アクセシビリティ機能は、Android用Windowsサブシステムでは現在サポートされていません。
- 解決策： サポートされていないハードウェア機能およびソフトウェア機能については、次のガイドラインに従います。
- アプリのマニフェストの
uses-feature宣言にandroid: required="false"を追加します。 - アプリの機能を無効にします。モバイルアプリに同じAPKを使用している場合は、条件付きロジックを使用して、Android用Windowsサブシステムでサポートされていない機能を無効にします。
- アプリのマニフェストの
- アプリ内の広告（ad）が表示されない
- 原因： アプリ内広告に使用される広告SDKは、Android用Windowsサブシステムと互換性がない場合があります。
- 解決策： 互換性がない場合は、次のガイドラインに従って広告SDKを無効にします。
- バナー、インタースティシャル、広告リワード（広告視聴の対価としてアプリ内リワードをユーザーに付与するもの）を含む、すべてのモバイル広告ユニットを無効にします。例については、サポートされていない広告SDKの無効化を参照してください。
- 広告リワードに依存するアプリの機能を無効にします。たとえば、リワード広告の視聴にボタンのクリックが必要な場合は、そのボタンを無効にするか削除します。
- モバイルアプリに同じAPKを使用している場合は、条件付きロジックを使用して、Android用Windowsサブシステムにのみ変更を加えます。
- 広告（ad）の音声が空白の画面で再生される
- 原因： アプリ内広告に使用される広告SDKは、Android用Windowsサブシステムと互換性がない場合があります。
- 解決策： 互換性がない場合は、次のガイドラインに従って広告SDKを無効にします。
- バナー、インタースティシャル、広告リワード（広告視聴の対価としてアプリ内リワードをユーザーに付与するもの）を含む、すべてのモバイル広告ユニットを無効にします。例については、サポートされていない広告SDKの無効化を参照してください。
- 広告リワードに依存するアプリの機能を無効にします。たとえば、リワード広告の視聴にボタンのクリックが必要な場合は、そのボタンを無効にするか削除します。
- モバイルアプリに同じAPKを使用している場合は、条件付きロジックを使用して、Android用Windowsサブシステムにのみ変更を加えます。
- アプリ内の広告（ad）を表示しても、ボーナスポイントやその他の消費型アイテムが付与されない
- 原因： アプリ内広告に使用される広告SDKは、Android用Windowsサブシステムと互換性がない場合があります。
- 解決策： 互換性がない場合は、次のガイドラインに従って広告SDKを無効にします。
- バナー、インタースティシャル、広告リワード（広告視聴の対価としてアプリ内リワードをユーザーに付与するもの）を含む、すべてのモバイル広告ユニットを無効にします。例については、サポートされていない広告SDKの無効化を参照してください。
- 広告リワードに依存するアプリの機能を無効にします。たとえば、リワード広告の視聴にボタンのクリックが必要な場合は、そのボタンを無効にするか削除します。
- モバイルアプリに同じAPKを使用している場合は、条件付きロジックを使用して、Android用Windowsサブシステムにのみ変更を加えます。
- 広告（ad）によってGoogle Playストアにリダイレクトされる
- 原因： アプリ内広告に使用される広告SDKは、Android用Windowsサブシステムと互換性がない場合があります。
- 解決策： 互換性がない場合は、次のガイドラインに従って広告SDKを無効にします。
- バナー、インタースティシャル、広告リワード（広告視聴の対価としてアプリ内リワードをユーザーに付与するもの）を含む、すべてのモバイル広告ユニットを無効にします。例については、サポートされていない広告SDKの無効化を参照してください。
- 広告リワードに依存するアプリの機能を無効にします。たとえば、リワード広告の視聴にボタンのクリックが必要な場合は、そのボタンを無効にするか削除します。
- モバイルアプリに同じAPKを使用している場合は、条件付きロジックを使用して、Android用Windowsサブシステムにのみ変更を加えます。
- キーボードの矢印キー（arrow key）が動作しない、または予期しない動作をする
- 原因： キーストロークがフレームワークによって自動的に処理されないことがあります。
- 解決策： キーボード入力に関するAndroidのガイドラインに従います。キーボード入力を最適化するには、次のAndroidデベロッパーガイドを参照してください。
- 縦横比（aspect ratio）が正しく表示されない
- 原因： 大画面デバイスに特有の縦横比をアプリがサポートしていない可能性があります。
- 解決策： 16:9、16:10、3:2など、複数の縦横比にアプリを対応させます。
- コンピューターに接続されたオーディオデバイス（audio device）がアプリで認識されない
- 原因： Android用Windowsサブシステムでは、接続されたオーディオデバイスをアプリで検出できません。
- 解決策： サポートされていないハードウェア機能およびソフトウェア機能については、次のガイドラインに従います。
- アプリのマニフェストの
uses-feature宣言にandroid: required="false"を追加します。 - アプリの機能を無効にします。モバイルアプリに同じAPKを使用している場合は、条件付きロジックを使用して、Android用Windowsサブシステムでサポートされていない機能を無効にします。
- アプリのマニフェストの
- オーディオ（audio）がアプリの最小化時・画面ロック時・デバイスの休止状態中でも再生され続ける
- 原因： ウィンドウメカニズムやアクティビティライフサイクルが、Windowsデバイス向けに最適化されていない可能性があります。
- 解決策： 次のガイドラインに従います。
- ウィンドウメカニズムをサポートするには、Androidデベロッパーガイドのマルチウィンドウのサポートを参照してください。
- アプリの状態の保存および読み込みを正確かつ一貫して行うには、マルチウィンドウモードに関連するアクティビティのライフサイクルを処理します。詳細については、Androidデベロッパーガイドのマルチウィンドウモードでのアクティビティのライフサイクルを参照してください。
- オーディオ（audio）が録音されない
- 原因： システムオーディオの録音は、Android用Windowsサブシステムでは現在サポートされていません。
- 解決策： Android用Windowsサブシステム向けのアプリのシステムオーディオ録音機能を無効にします。注： マイク録音はサポートされており、想定どおりに機能します。
B
- 気圧計（barometer）機能が機能しない
- 原因： 気圧計機能は、Android用Windowsサブシステムでは現在サポートされていません。
- 解決策： サポートされていないハードウェア機能およびソフトウェア機能については、次のガイドラインに従います。
- アプリのマニフェストの
uses-feature宣言にandroid: required="false"を追加します。 - アプリの機能を無効にします。モバイルアプリに同じAPKを使用している場合は、条件付きロジックを使用して、Android用Windowsサブシステムでサポートされていない機能を無効にします。
- アプリのマニフェストの
- Bluetooth接続が機能しない
- 原因： Android用Windowsサブシステムでは、Bluetoothは使用可能と表示されますが、現在動作しません。
- 解決策： Android用Windowsサブシステムで使用可能と表示されるものの動作しないハードウェア機能については、Android用Windowsサブシステムでの実行時にその機能を使用しないようにするロジックをアプリに追加する必要があります。
- 輝度（brightness）の設定が機能しない
- 原因： 輝度の設定は、Android用Windowsサブシステムでは現在サポートされていません。
- 解決策： サポートされていないハードウェア機能およびソフトウェア機能については、次のガイドラインに従います。
- アプリのマニフェストの
uses-feature宣言にandroid: required="false"を追加します。 - アプリの機能を無効にします。モバイルアプリに同じAPKを使用している場合は、条件付きロジックを使用して、Android用Windowsサブシステムでサポートされていない機能を無効にします。
- アプリのマニフェストの
- アプリのボタン（button）が応答しない
- 原因1：
ActivityNotFoundExceptionが原因である可能性があります。 - 解決策1： アプリをWindowsデバイスに移植する前に、例外を適切に処理します。
- 原因2： アプリ内広告に広告SDKを使用している場合、Windowsとの互換性がない可能性があります。Android用Windowsサブシステムで広告の付与や配信が適切に行われず、そのためにボタンが応答しなくなっています。
- 解決策2： 互換性がない場合は、次のガイドラインに従って広告SDKを無効にします。
- バナー、インタースティシャル、広告リワード（広告視聴の対価としてアプリ内リワードをユーザーに付与するもの）を含む、すべてのモバイル広告ユニットを無効にします。例については、サポートされていない広告SDKの無効化を参照してください。
- 広告リワードに依存するアプリの機能を無効にします。たとえば、リワード広告の視聴にボタンのクリックが必要な場合は、そのボタンを無効にするか削除します。
- モバイルアプリに同じAPKを使用している場合は、条件付きロジックを使用して、Android用Windowsサブシステムにのみ変更を加えます。
- 原因3： 応答しないボタンがデバイスのハードウェア機能やソフトウェア機能に関連している場合、その機能がAndroid用Windowsサブシステムでサポートされていない可能性があります。
- 解決策3： サポートされていないハードウェア機能およびソフトウェア機能については、次のガイドラインに従います。
- アプリのマニフェストの
uses-feature宣言にandroid: required="false"を追加します。 - アプリの機能を無効にします。モバイルアプリに同じAPKを使用している場合は、条件付きロジックを使用して、Android用Windowsサブシステムでサポートされていない機能を無効にします。
- アプリのマニフェストの
C
- カメラ（camera）機能が動作しない
- 原因： Windowsデバイスで使用可能なカメラをサポート対象にしていない可能性があります。
- 解決策： Android用Windowsサブシステムでカメラを使用する際は、次のガイドラインに従います。
- デバイスのカメラを使用する前に、Androidの
CameraManagerAPIを使用して利用可能なカメラデバイスを確認します。モバイルデバイスとは異なり、Windowsデバイスでは、単一または複数のカメラが搭載されている場合、カメラがない場合、外部カメラを使用する場合があります。Amazonアプリストアでは、考えられるケースそれぞれに対応することをお勧めします。 - Windowsデバイスのカメラでサポートされているプレビューサイズを確認し、写真の撮影やプレビューの表示に使用します。
- ノートパソコンなどの横向きデバイスでアプリの向きをテストし、それに応じて回転を調整します。
- デバイスのカメラを使用する前に、Androidの
- カメラ（camera）エラー： 「ハードウェアがこのアプリをサポートしていません」
- 原因： この問題は、レガシーネイティブライブラリがAssets/Plugins/Android/lib/armeabiフォルダに存在する場合に発生します。ネイティブライブラリをビルドすると、x86、armeabi、armeabi-v7aなどの出力がデフォルトで作成されますが、Unity 5.xではarmeabiのサポートが廃止されています。
- 解決策： Unity 5.x以降ではarmeabiを使用しないようにします。
- カメラ（camera）で写真が間違った向きで撮影される
- カメラで撮影した写真（picture）の向きが間違っているを参照してください。
- カメラ（camera）のプレビュー画像が表示されない
- 原因： Windowsデバイスのカメラでサポートされているプレビューサイズを使用していない可能性があります。
- 解決策： Android用Windowsサブシステムでカメラを使用する際は、次のガイドラインに従います。
- デバイスのカメラを使用する前に、Androidの
CameraManagerAPIを使用して利用可能なカメラデバイスを確認します。モバイルデバイスとは異なり、Windowsデバイスでは、単一または複数のカメラが搭載されている場合、カメラがない場合、外部カメラを使用する場合があります。Amazonアプリストアでは、考えられるケースそれぞれに対応することをお勧めします。 - Windowsデバイスのカメラでサポートされているプレビューサイズを確認し、写真の撮影やプレビューの表示に使用します。
- ノートパソコンなどの横向きデバイスでアプリの向きをテストし、それに応じて回転を調整します。
- デバイスのカメラを使用する前に、Androidの
- コンパス（compass）機能が動作しない
- 原因： コンパス機能は、Android用Windowsサブシステムではサポートされていません。
- 解決策： サポートされていないハードウェア機能およびソフトウェア機能については、次のガイドラインに従います。
- アプリのマニフェストの
uses-feature宣言にandroid: required="false"を追加します。 - アプリの機能を無効にします。モバイルアプリに同じAPKを使用している場合は、条件付きロジックを使用して、Android用Windowsサブシステムでサポートされていない機能を無効にします。
- アプリのマニフェストの
- 起動時にアプリ内のコンテンツ（content）が切れる、または表示されない
- 原因： 初期起動サイズの設定が必要な場合があります。
- 解決策： Androidデベロッパードキュメントの初期起動サイズに関する推奨事項に従います。
- ウィンドウサイズ変更後にアプリ内のコンテンツ（content）が切れる、または表示されない
- 原因： ウィンドウのサイズ変更時にコンテンツの境界が変更されています。
- 解決策： Androidデベロッパードキュメントのコンテンツ境界に関する推奨事項に従います。
- Ctrlキーベースのショートカットが機能しない（例：Ctrl-Cでコピー、Ctrl-Vで貼り付け、Ctrl-Xで切り取り、Ctrl-Zで元に戻す）
- 原因： キーストロークがフレームワークによって自動的に処理されないことがあります。
- 解決策： キーボード入力に関するAndroidのガイドラインに従います。キーボード入力を最適化するには、次のAndroidデベロッパーガイドを参照してください。
D
- デバイス（device）のペアリングが機能しない
- Bluetooth接続が機能しないを参照してください。
- マウスによるドラッグアンドドロップ（drag and drop）が機能しない
- 原因： マウス入力がフレームワークによって自動的に処理されないことがあります。
- 解決策： マウス入力に関するAndroidのガイドラインに従います。マウス入力を最適化するには、次のAndroidデベロッパーガイドを参照してください。
E
- イヤホン（earphone）が検出されない
- 原因： Android用Windowsサブシステムでは、イヤホンやヘッドホンなど、接続されているオーディオデバイスを検出できません。
- 解決策： アプリにイヤホンが必要で、必須の検証に
isAudioConnectedメソッドを使用する場合は、Android用Windowsサブシステムのアプリに対するこの必須の検証をスキップするか無視します。 - オーディオデバイスの処理方法の詳細については、コンピューターに接続されたオーディオデバイス（audio device）がアプリで認識されないを参照してください。
- Widevine L1またはL2 DRMで暗号化（encrypt）されたビデオが再生されない
- Widevine L1またはL2 DRMで暗号化されたビデオ（video）が再生されないを参照してください。
- Enterキーが応答しない、または予期しない動作をする
- 原因： キーストロークがフレームワークによって自動的に処理されないことがあります。
- 解決策： キーボード入力に関するAndroidのガイドラインに従います。キーボード入力を最適化するには、次のAndroidデベロッパーガイドを参照してください。
F
- Facebook認証が機能しない
- 原因： 古いバージョンのAndroid用Facebook SDKを使用している可能性があります。
- 解決策： 次のガイドラインに従います。
- Android用Facebook SDKをバージョン8.2.0以降にアップグレードします。
- WebViewではなくカスタムタブ（英語のみ）を使用します。
LoginBehaviorの列挙型がWEB_VIEW_ONLYに設定されていないことを確認します。- Facebook SDKの
CustomTabMainActivityクラスおよびCustomTabActivityクラスへの参照を削除します。 - マニフェストにインテントフィルターを追加し、カスタムタブ用に構成します。詳細については、Facebook開発者向けドキュメントのリソースとマニフェストを編集するを参照してください。
- ファイル（file）を検出できない、またはファイルにアクセスできない
- 原因： アプリが対象範囲別ストレージを使用していない可能性があります。対象範囲別ストレージは、Android 10で導入され、Android 11で強化されたAndroidの機能です。対象範囲別ストレージでは、アプリは外部ストレージにあるアプリ固有のディレクトリと、そのアプリが作成したメディアにのみアクセスできます。
- 解決策： アプリで対象範囲別ストレージを処理するには、AndroidデベロッパーガイドのAndroidストレージのユースケースとおすすめの方法を参照してください。
- アプリによって生成されたファイル（file）を保存できない
- 原因： ファイル名が無効である可能性があります。Androidでは、ファイル名に無効な文字が含まれているとファイルが保存されないよう変更が加えられています。以前のバージョンのAndroidでは、無効な文字が置き換えられていましたが、新しいバージョンのAndroidでは、名前に無効な文字を含むファイルを保存しようとすると失敗します。
- 解決策： アプリが保存するファイルの名前に無効な文字が含まれないようにします。たとえば、名前にタイムスタンプが含まれるファイルで、タイムスタンプにコロン（
:）が使用されている場合、そのファイルは保存できません。 - フレームレート（framerate）が低い
- 原因： アプリのフレームレートが、Windowsコンピューターよりも低機能なモバイルデバイス向けに最適化されている場合があります。
- 解決策： Windowsコンピューターのユーザーは、モバイルユーザーよりも高いフレームレートでアプリを実行できる可能性が高いため、最大フレームレートを60fps以上に設定するか、フレームレート制限をすべて削除します。
G
- Google Play開発者サービスにリダイレクトされる
- 原因： デバイスの製造元IDから製造元がAmazonでないことが確認されると、Google Play開発者サービスにリダイレクトされます。Windowsの製造元はAmazonではなくMicrosoftであるため、Windowsデバイスではこのリダイレクトが発生します。
- 解決策： デバイスの検出に製造元IDを使用せず、代わりに特定のサービスを確認します。ガイドラインについては、サポートされていないGoogle Play開発者サービスの処理を参照してください。
- Google+ログインが機能しない
- 原因： Google+ログインは2019年に廃止されました。廃止された機能を使用すると、Android用Windowsサブシステムでアプリに問題が生じます。
- 解決策： コード内のGoogle+ログインへの参照を削除します。
- ジャイロスコープ（gyroscope）機能が動作しない
- 原因： ジャイロスコープ機能は、Android用Windowsサブシステムではサポートされていません。
- 解決策： サポートされていないハードウェア機能およびソフトウェア機能については、次のガイドラインに従います。
- アプリのマニフェストの
uses-feature宣言にandroid: required="false"を追加します。 - アプリの機能を無効にします。モバイルアプリに同じAPKを使用している場合は、条件付きロジックを使用して、Android用Windowsサブシステムでサポートされていない機能を無効にします。
- アプリのマニフェストの
H
- ヘッドホン（headphone）が検出されない
- イヤホン（earphone）が検出されないを参照してください。
- 選択したアイテムにハイライト（highlight）が表示されない
- 原因： キーボードを使用して選択したアイテムのハイライト表示が、フレームワークによって自動的に処理されないことがあります。
- 解決策： キーボード入力に関するAndroidのガイドラインに従います。キーボード入力を最適化するには、次のAndroidデベロッパーガイドを参照してください。
- マウスのホバー効果（hover effect）が機能しない
- 原因： マウス入力がフレームワークによって自動的に処理されないことがあります。
- 解決策： マウス入力に関するAndroidのガイドラインに従います。マウス入力を最適化するには、次のAndroidデベロッパーガイドを参照してください。
I
- アプリ内広告（in-app ad）が表示されない
- アプリ内の広告（ad）が表示されないを参照してください。
- アプリ内広告（in-app ad）を表示しても、ボーナスポイントやその他の消費型アイテムが付与されない
- アプリ内の広告（ad）を表示しても、ボーナスポイントやその他の消費型アイテムが付与されないを参照してください。
- アプリ内課金（IAP）が想定どおりに動作しない
- 原因： アプリがIAP APIと適切に統合されていない可能性があります。
- 解決策： Appstore SDK（IAP APIが含まれている）がアプリに適切に統合されていることを確認します。アプリがGoogle Play請求サービスを使用している場合は、Google Play請求サービスからAmazonアプリ内課金（IAP）への移行ガイドに従ってください。それ以外の場合は、ガイドに従ってアプリにIAP APIを組み込みます。
- 赤外線（IR）機能が動作しない
- 原因： 赤外線機能は、Android用Windowsサブシステムでは現在サポートされていません。
- 解決策： サポートされていないハードウェア機能およびソフトウェア機能については、次のガイドラインに従います。
- アプリのマニフェストの
uses-feature宣言にandroid: required="false"を追加します。 - アプリの機能を無効にします。モバイルアプリに同じAPKを使用している場合は、条件付きロジックを使用して、Android用Windowsサブシステムでサポートされていない機能を無効にします。
- アプリのマニフェストの
K
- キーボード（kyeboard）ナビゲーションが機能しない、または予期しない動作をする
- キーボードの矢印キー（arrow key）が動作しない、または予期しない動作をするを参照してください。
L
- アプリでレターボックス（letterboxing）が発生する（ウィンドウの上下にバーが表示される）
- 原因： 表示ウィンドウの縦横比がコンテンツと一致していません。ウィンドウは横に細長く、バーがウィンドウの上部と下部に配置されています。バーは、システム設定に応じてライトテーマまたはダークテーマになります。
- 解決策： レターボックスは、アプリのスナップ・最大化・手動によるサイズ変更時にコンテンツの縦横比を維持するための機能です。
- 光センサー（light sensor）が機能しない
- 原因： 光センサー機能は、Android用Windowsサブシステムではサポートされていません。
- 解決策： サポートされていないハードウェア機能およびソフトウェア機能については、次のガイドラインに従います。
- アプリのマニフェストの
uses-feature宣言にandroid: required="false"を追加します。 - アプリの機能を無効にします。モバイルアプリに同じAPKを使用している場合は、条件付きロジックを使用して、Android用Windowsサブシステムでサポートされていない機能を無効にします。
- アプリのマニフェストの
- 同じローカルネットワーク（local network）上でアプリを実行しているデバイスに接続できない
- 原因： 接続するためには、Android用Windowsサブシステムでネットワークの詳細設定が有効になっている必要があります。
- 解決策： Android用Windowsサブシステムでネットワークの詳細設定を有効にします。
- FacebookまたはGoogle+でログイン（login）できない
- Facebookについては、Facebook認証が機能しないを参照してください。
Google+については、Google+ログインが機能しないを参照してください。
M
- MIDIデバイスが接続されない
- 原因： MIDIデバイス機能は、Android用Windowsサブシステムでは現在サポートされていません。
- 解決策： サポートされていないハードウェア機能およびソフトウェア機能については、次のガイドラインに従います。
- アプリのマニフェストの
uses-feature宣言にandroid: required="false"を追加します。 - アプリの機能を無効にします。モバイルアプリに同じAPKを使用している場合は、条件付きロジックを使用して、Android用Windowsサブシステムでサポートされていない機能を無効にします。
- アプリのマニフェストの
- マウスオーバー（mouse over）効果が機能しない
- マウスのホバー効果（hover effect）が機能しないを参照してください。
- マウス右クリック（mouse right click）が機能しない
- マウスの右クリック（right click）が機能しないを参照してください。
N
- ニアフィールド通信（NFC）機能が動作しない
- 原因： NFC機能は、Android用Windowsサブシステムでは現在サポートされていません。
- 解決策： サポートされていないハードウェア機能およびソフトウェア機能については、次のガイドラインに従います。
- アプリのマニフェストの
uses-feature宣言にandroid: required="false"を追加します。 - アプリの機能を無効にします。モバイルアプリに同じAPKを使用している場合は、条件付きロジックを使用して、Android用Windowsサブシステムでサポートされていない機能を無効にします。
- アプリのマニフェストの
P
- 電話ネットワーク（phone network）機能が動作しない
- 原因： 電話ネットワーク機能は、Android用Windowsサブシステムではサポートされていません。
- 解決策： サポートされていないハードウェア機能およびソフトウェア機能については、次のガイドラインに従います。
- アプリのマニフェストの
uses-feature宣言にandroid: required="false"を追加します。 - アプリの機能を無効にします。モバイルアプリに同じAPKを使用している場合は、条件付きロジックを使用して、Android用Windowsサブシステムでサポートされていない機能を無効にします。
- アプリのマニフェストの
- カメラで撮影した写真（picture）の向きが間違っている
- 原因： 縦向きでのみ実行できるアプリを横向き画面で実行すると、カメラの問題が発生する可能性があります。その場合、プレビューやキャプチャ結果が正しく回転しないことがあります。
- 解決策： Android用Windowsサブシステムでカメラを使用する際は、次のガイドラインに従います。
- デバイスのカメラを使用する前に、Androidの
CameraManagerAPIを使用して利用可能なカメラデバイスを確認します。モバイルデバイスとは異なり、Windowsデバイスでは、単一または複数のカメラが搭載されている場合、カメラがない場合、外部カメラを使用する場合があります。Amazonアプリストアでは、考えられるケースそれぞれに対応することをお勧めします。 - Windowsデバイスのカメラでサポートされているプレビューサイズを確認し、写真の撮影やプレビューの表示に使用します。
- ノートパソコンなどの横向きデバイスでアプリの向きをテストし、それに応じて回転を調整します。
- デバイスのカメラを使用する前に、Androidの
- アプリでピラーボックス（pillarboxing）が発生する（ウィンドウの左右にバーが表示される）
- 原因： 表示ウィンドウの縦横比がコンテンツと一致していません。ウィンドウは縦に細長く、バーがウィンドウの右側と左側に配置されています。バーは、システム設定に応じてライトテーマまたはダークテーマになります。
- 解決策： ピラーボックスは、アプリのスナップ・最大化・手動によるサイズ変更時にコンテンツの縦横比を維持するための機能です。
- 近接センサー（proximity sensor）が機能しない
- 原因： 近接センサー機能は、Android用Windowsサブシステムではサポートされていません。
- 解決策： サポートされていないハードウェア機能およびソフトウェア機能については、次のガイドラインに従います。
- アプリのマニフェストの
uses-feature宣言にandroid: required="false"を追加します。 - アプリの機能を無効にします。モバイルアプリに同じAPKを使用している場合は、条件付きロジックを使用して、Android用Windowsサブシステムでサポートされていない機能を無効にします。
- アプリのマニフェストの
R
- マウスの右クリック（right click）が機能しない
- 原因： マウス入力がフレームワークによって自動的に処理されないことがあります。
- 解決策： マウス入力に関するAndroidのガイドラインに従います。マウス入力を最適化するには、次のAndroidデベロッパーガイドを参照してください。
S
- 選択（select）したアイテムがハイライトされない
- 選択したアイテムにハイライト（highlight）が表示されないを参照してください。
- スリープ（sleep）を解除するとアプリが再起動する
- 原因： ウィンドウメカニズムやアクティビティライフサイクルが、Windowsデバイス向けに最適化されていない可能性があります。
- 解決策： 次のガイドラインに従います。
- ウィンドウメカニズムをサポートするには、Androidデベロッパーガイドのマルチウィンドウのサポートを参照してください。
- アプリの状態の保存および読み込みを正確かつ一貫して行うには、マルチウィンドウモードに関連するアクティビティのライフサイクルを処理します。詳細については、Androidデベロッパーガイドのマルチウィンドウモードでのアクティビティのライフサイクルを参照してください。
- サウンド（sound）がアプリの最小化時・画面ロック時・デバイスの休止状態中でも再生され続ける
- オーディオ（audio）がアプリの最小化時・画面ロック時・デバイスの休止状態中でも再生され続けるを参照してください。
- サウンド（sound）が録音されない
- オーディオ（audio）が録音されないを参照してください。
- サウンド（sound）の設定が機能しない
- 原因： システムサウンドの設定は、Android用Windowsサブシステムでは現在サポートされていません。
- 解決策： システム設定にアプリの音量制御をリクエストしないようにします。Android用Windowsサブシステムでは、システム設定へのサウンドに関するリクエストはサポートされていません。サウンドに関するシステム設定を最適化するには、Androidデベロッパーガイドの固定音量デバイスへの対応を参照してください。
- 歩数（steps）の計測が機能しない
- 原因： 歩数計機能および歩行検出機能は、Android用Windowsサブシステムではサポートされていません。
- 解決策： サポートされていないハードウェア機能およびソフトウェア機能については、次のガイドラインに従います。
- アプリのマニフェストの
uses-feature宣言にandroid: required="false"を追加します。 - アプリの機能を無効にします。モバイルアプリに同じAPKを使用している場合は、条件付きロジックを使用して、Android用Windowsサブシステムでサポートされていない機能を無効にします。
- アプリのマニフェストの
T
- Tabキーが応答しない、または予期しない動作をする
- 原因： キーストロークがフレームワークによって自動的に処理されないことがあります。
- 解決策： キーボード入力に関するAndroidのガイドラインに従います。キーボード入力を最適化するには、次のAndroidデベロッパーガイドを参照してください。
- マウスのツールチップ（tool tip）とホバーテキストが機能しない
- マウスのホバー効果（hover effect）が機能しないを参照してください。
U
- UIが画面の左上隅で切れる
- 原因： Android 13の問題です。アプリの
targetSdkVersionが4未満に設定されていて、アプリのマニフェストで<supports-screens>要素のanyDensity属性がtrueに設定されている場合に影響を受けます。 - 解決策： アプリを更新して、
targetSdkVersionを4以上に設定します。Amazonアプリストアでは、デバイス間の互換性を高め、プライバシーとセキュリティ機能を強化するために、APIレベル33または最新バージョンのAndroidをサポートするようにアプリを更新することを推奨しています。 - UIが適切なサイズで表示されない
- 原因： 大きな画面では、UI要素が適切なサイズで表示されないことがあります。
- 解決策： UI要素のサイズを調整します。HUDは画面の20%未満にする必要があります。
- アプリに更新ポップアップ（update popup）が表示される
- 原因： アプリが古いバージョンのAndroid向けに作成されていて、ウィンドウメカニズムとアクティビティライフサイクルがWindowsデバイス向けに最適化されていない可能性があります。
- 解決策： 次のガイドラインに従います。
- ウィンドウメカニズムをサポートするには、Androidデベロッパーガイドのマルチウィンドウのサポートを参照してください。
- アプリの状態の保存および読み込みを正確かつ一貫して行うには、マルチウィンドウモードに関連するアクティビティのライフサイクルを処理します。詳細については、Androidデベロッパーガイドのマルチウィンドウモードでのアクティビティのライフサイクルを参照してください。
- USB機能が動作しない
- 原因： Android用Windowsサブシステムでは、USB機能は使用可能と表示されますが、現在動作しません。
- 解決策： Android用Windowsサブシステムで使用可能と表示されるものの動作しないハードウェア機能については、Android用Windowsサブシステムでの実行時にその機能を使用しないようにするロジックをアプリに追加する必要があります。
V
- Widevine L1またはL2 DRMで暗号化されたビデオ（video）が再生されない
- 原因： Android用Windowsサブシステムは、Widevine L1またはL2をサポートしていません。
- 解決策： 可能であれば、Widevine L3暗号化を使用してください。
- 音量制御（volume control）が機能しない
- サウンド（sound）の設定が機能しないを参照してください。
W
- Wi-Fi Directが機能しない
- 原因： Wi-Fi Directは、Android用Windowsサブシステムでは現在サポートされていません。
- 解決策： サポートされていないハードウェア機能およびソフトウェア機能については、次のガイドラインに従います。
- アプリのマニフェストの
uses-feature宣言にandroid: required="false"を追加します。 - アプリの機能を無効にします。モバイルアプリに同じAPKを使用している場合は、条件付きロジックを使用して、Android用Windowsサブシステムでサポートされていない機能を無効にします。
- アプリのマニフェストの
- Wi-Fiホットスポットが機能しない
- 原因： Wi-Fiホットスポットは、Android用Windowsサブシステムでは現在サポートされていません。
- 解決策： サポートされていないハードウェア機能およびソフトウェア機能については、次のガイドラインに従います。
- アプリのマニフェストの
uses-feature宣言にandroid: required="false"を追加します。 - アプリの機能を無効にします。モバイルアプリに同じAPKを使用している場合は、条件付きロジックを使用して、Android用Windowsサブシステムでサポートされていない機能を無効にします。
- アプリのマニフェストの
- アプリによって（LANゲームのホストやファイル転送のために）作成されたWi-Fiホットスポットが機能しない
- Wi-Fiホットスポットが機能しないを参照してください。
- Wi-Fiスキャンが機能しない
- 原因： Android用Windowsサブシステムは仮想Wi-Fiを使用するため、Wi-Fi信号を直接確認できません。Wi-Fi信号をスキャンするアプリには、利用可能なWi-Fiネットワークは表示されません。
- 解決策： サポートされていないハードウェア機能およびソフトウェア機能については、次のガイドラインに従います。
- アプリのマニフェストの
uses-feature宣言にandroid: required="false"を追加します。 - アプリの機能を無効にします。モバイルアプリに同じAPKを使用している場合は、条件付きロジックを使用して、Android用Windowsサブシステムでサポートされていない機能を無効にします。
- アプリのマニフェストの
- Widevine L1またはL2のDRM暗号化ビデオが再生されない
- Widevine L1またはL2 DRMで暗号化されたビデオ（video）が再生されないを参照してください。
Last updated: 2023年6月30日