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

[アーティクル]
03/04/2024

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

Note

すべての種類の自動再生にデバイスメタデータを使用する必要はありません。デバイスメタデータがなくても、自動再生を使用すれば、ユーザーがデバイスを PC に接続するときにオプションとしてアプリを提供できます。これには、カメラやメディアプレーヤーなどの非ボリュームデバイスや、USB ドライブ、SD カード、DVD などのボリュームデバイスが含まれます。自動再生を使用すると、ユーザーが近接通信 (タップ) を使用して 2 台のコンピューター間でファイルを共有する場合に、アプリをオプションとして登録することもできます。ただし、デバイスメタデータがない場合は、アプリを自動的にインストールすることはできません。デバイスメタデータが必要ない場合に自動再生を使用する方法の詳細については、「自動再生を使用した自動起動」を参照してください。

自動再生の概要

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

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

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

example autoplay dialog for a device.

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

デバイスクラス	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 アプリをデバイスの自動再生ハンドラーとして機能させることもできます。これらのオプションのどちらか、または両方を選択できます。

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

DeviceMetadataWizard.exe をダブルクリックして、%ProgramFiles(x86)%\Windows Kits\8.1\bin\x86 からデバイスメタデータ作成ウィザードを開始します。
[デバイスメタデータの編集] をクリックします。これにより、既存のデバイスメタデータパッケージを編集できます。
[開く] ダイアログボックスで、UWP デバイスアプリに関連付けられているデバイスメタデータパッケージを見つけます。 (devicemetadata-ms ファイル拡張子が付いています)
(省略可能。) デバイスアプリのパッケージ名、発行元名、アプリ ID が手元にない場合は、[アプリ情報] をクリックして、UWP デバイスアプリのパッケージ情報を表示します。
[Windows 情報] をクリックして、自動再生の詳細を指定します。
アプリをデバイスの既定の自動再生ハンドラーとして指定する場合は、[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 が自動的に指定されます。
他のアプリをデバイスの自動再生ハンドラーとして機能させる場合は、[登録済みアプリの自動再生を有効にする] を選択します。
終了したら [次へ]をクリックします。
[完了] ページが表示されたら、エクスペリエンス ID を書き留めます。アプリで自動再生のアクティブ化を処理する場合は、次の手順でそれが必要になります。
[情報の保存] 確認し、[保存] をクリックしてデバイスメタデータパッケージを更新します。

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

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

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

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

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

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>

この例の自動再生の値を、アプリの実際の値に置き換えます。
- 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

次の方法で共有

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

自動再生の概要

開始する前に

自動再生の有効化

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

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

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

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

フィードバック

その他のリソース

次の方法で共有

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

自動再生の概要

開始する前に

自動再生の有効化

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

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

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

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

関連トピック

フィードバック

その他のリソース

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

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