UWP デバイス アプリの自動再生

デバイスの製造元は、デバイスの自動再生ハンドラーとして自社 UWP デバイス アプリを指定できます。 他の UWP アプリをデバイスの自動再生ハンドラーとして機能させることもできます。 このトピックでは、デバイス メタデータの作成ウィザードを使用して、自動再生を有効にする方法について説明しています。 アプリで自動再生のアクティブ化を処理する方法についても説明しています。 デバイス アプリの詳細については、「UWP デバイス アプリの概要」を参照してください。

自動再生の概要

アプリのバージョンに応じて、次の方法で自動再生を有効にできます。

• 自社の UWP デバイス アプリでのみ、デバイスの自動再生のアクティブ化を処理できる (Windows 8、Windows 8.1 でサポートされています)。

• 他の UWP アプリでデバイスの自動再生のアクティブ化を処理できる (Windows 8.1 でのみサポートされています)。

• 自社の UWP デバイス アプリと他の UWP アプリで、デバイスの自動再生のアクティブ化を処理できる (Windows 8.1 でのみサポートされています)。

次の例は、Contoso Pedometer デバイスの自動再生ハンドラーとして登録されている、Contoso ダッシュボードという名前のアプリの自動再生ダイアログを示しています。

アプリでデバイス メタデータを使用する場合、自動再生では次のデバイスの種類がサポートされます。

デバイス クラス	Windows 8 でサポートされている自動再生	Windows 8.1 でサポートされている自動再生
デジタル スチル カメラ
デジタル ビデオ カムコーダー
ポータブル メディア プレーヤー
携帯電話
モバイル ブロードバンド
Web カメラ
ヒューマン インターフェイス デバイス (HID)
プリンター、スキャナー、FAX
PC
スマート カード
一般ポート
Bluetooth デバイス

開始する前に

• デバイス メタデータ作成ウィザードがあることを確認します。 自動再生を有効にするのに必要です。 このリリースでは、このウィザードは Microsoft Visual Studio Professional と Microsoft Visual Studio Ultimate に含まれています。 ただし、Microsoft Visual Studio Express for Windows をお持ちの場合は、Windows 8.1 用スタンドアロン SDK をダウンロードしてウィザードを取得する必要があります。

• アプリを Microsoft Store に関連付けます。 自動再生を有効にするには、アプリのパッケージ情報が必要です。 詳細については、「手順 1: UWP デバイス アプリを作成する」の「Microsoft Store にアプリを関連付ける」セクションを参照してください。

• デバイス メタデータを作成します。 それをまだ開始していない場合は、「UWP デバイス アプリを手順に従って作成する」ガイドの「手順 2: デバイス メタデータを作成する」を参照してください。

自動再生の有効化

デバイス メタデータ作成ウィザードを使用すると、自社の UWP アプリをデバイスの既定の自動再生ハンドラーとして宣言できます。 他の UWP アプリをデバイスの自動再生ハンドラーとして機能させることもできます。 これらのオプションのどちらか、または両方を選択できます。

デバイス メタデータ作成ウィザードで自動再生を有効にするには**

1. DeviceMetadataWizard.exe をダブルクリックして、%ProgramFiles(x86)%\Windows Kits\8.1\bin\x86 からデバイス メタデータ作成ウィザードを開始します。

2. [デバイス メタデータの編集] をクリックします。 これにより、既存のデバイス メタデータ パッケージを編集できます。

3. [開く] ダイアログ ボックスで、UWP デバイス アプリに関連付けられているデバイス メタデータ パッケージを見つけます。 (devicemetadata-ms ファイル拡張子が付いています)

4. (省略可能。) デバイス アプリのパッケージ名、発行元名、アプリ ID が手元にない場合は、[アプリ情報] をクリックして、UWP デバイス アプリのパッケージ情報を表示します。

5. [Windows 情報] をクリックして、自動再生の詳細を指定します。

6. アプリをデバイスの既定の自動再生ハンドラーとして指定する場合は、[UWP デバイス アプリを使用する] を選択します。 任意の UWP アプリまたは UWP デバイス アプリを選択できますが、そのアプリで、デバイスの自動再生のアクティブ化を処理し、アプリ パッケージ マニフェストで対応するエクスペリエンス ID を指定する必要があります (次の手順での説明)。

   • Package name: アプリ パッケージ マニフェストでは、これは Identity 要素の Name 属性です。

   • Publisher name: アプリ パッケージ マニフェストでは、これは Identity 要素の Publisher 属性です。

   • App ID: アプリ パッケージ マニフェストでは、これは Application 要素の ID 属性です。

   • Verb: これは、自動再生のアクティブ化の識別子です。 アプリではそれを使用して、アクティブ化がデバイスから実行されたかどうかを判断します。 Verb 設定には任意の値を設定できますが、open (予約済み) は除きます。

   • AutoPlay event type: Device のままにします。 デバイス メタデータでは、ウィザードによって、UWP デバイス アプリに関連付けられているエクスペリエンス ID が自動的に指定されます。

7. 他のアプリをデバイスの自動再生ハンドラーとして機能させる場合は、[登録済みアプリの自動再生を有効にする] を選択します。

8. 終了したら [次へ]をクリックします。

9. [完了] ページが表示されたら、エクスペリエンス ID を書き留めます。 アプリで自動再生のアクティブ化を処理する場合は、次の手順でそれが必要になります。

10. [情報の保存] 確認し、[保存] をクリックしてデバイス メタデータ パッケージを更新します。

自動再生のアクティブ化の処理

アプリで自動再生のアクティブ化を処理するには、アプリケーション オブジェクトが発生した場合に、windows.autoPlayDeviceアプリ パッケージ マニフェストで拡張機能に登録してから、そのイベントを処理OnActivatedする必要があります。 アプリは、複数のデバイスの自動再生ハンドラーとして登録できることにご注意ください。

アプリを自動再生ハンドラーとして登録するには

アプリをデバイスの自動再生ハンドラーとして登録するには、UWP デバイス アプリに関連付けられているエクスペリエンス ID と、アプリのアクティブ化に使用される自動再生の Verb と ActionDisplayName を指定する必要があります。

1. Microsoft Visual Studio でアプリのプロジェクトを開きます。

2. ソリューション エクスプローラーで、Package.appxmanifest ファイルを右クリックし、[コードの表示] を選択します。 これにより、アプリ パッケージ マニフェストが XML (テキスト) エディターに表示されます。

3. Application 要素の VisualElements 要素の下で、次の Extensions 要素をパッケージ マニフェスト ファイルに貼り付けます。

         <Extensions>
           <Extension Category="windows.autoPlayDevice">
             <AutoPlayDevice>
               <LaunchAction
                   Verb="showDevice1"
                   ActionDisplayName="Launch App for Device 1"
                   DeviceEvent="ExperienceID:{00000000-ABCD-EF00-0000-000000000000}"/>
             </AutoPlayDevice>
           </Extension>
         </Extensions>
   

4. この例の自動再生の値を、アプリの実際の値に置き換えます。

   • Verb: これは、自動再生のアクティブ化の識別子です。 アプリではそれを使用して、アクティブ化がデバイスから実行されたかどうかを判断します。 アプリがデバイスの既定の自動再生ハンドラーとして指定されていた場合、この値はデバイス メタデータで指定した Verb と一致するはずです。 アプリがデバイスの既定の自動再生ハンドラーとして指定されていなかった場合は、Verb 設定に任意の値を使用できますが、open (予約済み) は除きます。

   • ActionDisplayName: アプリの自動再生で表示される文字列。

   • Experience ID: アプリをデバイスに関連付けるエクスペリエンス ID GUID。 これは、前の手順で書き留めた値です。

自動再生のアクティブ化を処理するには

デバイスが自動再生のアクティブ化をトリガーすると、アクティブ化の種類は Windows.ApplicationModel.Activation.ActivationKind.device になります。 eventObj によって渡された OnActivated オブジェクトを使用して、アプリがどのようにアクティブ化されたかを確認します。 自動再生からのものである場合は、eventObj を使用して、アクティブ化の原因となったデバイス ID と自動再生の verb を確認します。

この例では、アクティブ化イベント パラメーター (eventObj) には、デバイスの ID とアクティブ化の verb が含まれています。

<!DOCTYPE html>
<html>
<head>
  <script type="text/javascript">
    function OnActivated(eventObj) {
        if (eventObj.kind == Windows.ApplicationModel.Activation.ActivationKind.launch) {
            // Activated by the user.
        }
        else if (eventObj.kind == Windows.ApplicationModel.Activation.ActivationKind.device) {
            // Activated by a device, for AutoPlay.
            // Device path = eventObj.deviceInformationId;
            // verb ("showDevice1") = eventObj.verb;
        }
    }

    Windows.UI.WebUI.WebUIApplication.addEventListener("activated", OnActivated, false);
  </script>
</head>

<body>
...
...
...
</body>
</html>

関連トピック

UWP デバイス アプリの概要

UWP デバイス アプリを手順に従って構築する

自動再生による自動起動

Launching, resuming, and multitasking