Bagikan melalui

AutoPlay untuk aplikasi perangkat UWP

  • Artikel

Produsen perangkat dapat menentukan aplikasi perangkat UWP mereka sebagai handler AutoPlay untuk perangkat mereka. Mereka juga dapat membiarkan aplikasi UWP lain bertindak sebagai penangan AutoPlay untuk perangkat mereka. Topik ini menjelaskan cara menggunakan Panduan Penulisan Metadata Perangkat untuk mengaktifkan AutoPlay. Ini juga menjelaskan cara menangani aktivasi AutoPlay di aplikasi Anda. Untuk informasi selengkapnya tentang aplikasi perangkat, lihat Memenuhi aplikasi perangkat UWP.

Catatan

Anda tidak perlu menggunakan metadata perangkat untuk semua jenis AutoPlay. Tanpa metadata perangkat, AutoPlay memungkinkan Anda menyediakan aplikasi sebagai opsi saat pengguna menghubungkan perangkat ke PC. Ini termasuk perangkat non-volume seperti kamera atau pemutar media, atau perangkat volume seperti drive jempol USB, kartu SD, atau DVD. AutoPlay juga memungkinkan Anda mendaftarkan aplikasi sebagai opsi saat pengguna berbagi file di antara dua komputer dengan menggunakan Kedekatan (mengetuk). Tetapi aplikasi Anda tidak dapat menginstal secara otomatis tanpa metadata perangkat. Untuk informasi selengkapnya tentang menggunakan AutoPlay saat metadata perangkat tidak diperlukan, lihat Peluncuran otomatis dengan AutoPlay.

Gambaran umum Pemutaran Otomatis

Bergantung pada versi aplikasi, Anda dapat mengaktifkan AutoPlay dengan cara berikut:

  • Hanya aplikasi perangkat UWP Anda yang dapat menangani aktivasi AutoPlay untuk perangkat Anda (didukung di Windows 8, Windows 8.1).

  • Aplikasi UWP lainnya dapat menangani aktivasi AutoPlay untuk perangkat Anda (hanya didukung di Windows 8.1).

  • Aplikasi perangkat UWP dan aplikasi UWP lainnya dapat menangani aktivasi AutoPlay untuk perangkat Anda (hanya didukung di Windows 8.1).

Contoh ini memperlihatkan dialog AutoPlay untuk aplikasi bernama Dasbor Contoso yang telah terdaftar sebagai handler AutoPlay untuk perangkat Contoso Pedometer :

example autoplay dialog for a device.

Saat menggunakan metadata perangkat dengan aplikasi Anda, AutoPlay mendukung jenis perangkat ini:

Kelas perangkat AutoPlay didukung di Windows 8 AutoPlay didukung di Windows 8.1
Kamera diam digital autoplay is supported for this device class in windows 8. autoplay is supported for this device class in windows 8.1
Camcorder video digital autoplay is supported for this device class in windows 8. autoplay is supported for this device class in windows 8.1
Pemutar media portabel autoplay is supported for this device class in windows 8. autoplay is supported for this device class in windows 8.1
Ponsel autoplay is supported for this device class in windows 8. autoplay is supported for this device class in windows 8.1
Broadband seluler autoplay is not supported for this device class in windows 8. autoplay is not supported for this device class in windows 8.1
Webcam autoplay is not supported for this device class in windows 8. autoplay is not supported for this device class in windows 8.1
Perangkat Antarmuka Manusia (HID) autoplay is not supported for this device class in windows 8. autoplay is supported for this device class in windows 8.1
Printer, pemindai, faks autoplay is not supported for this device class in windows 8. autoplay is not supported for this device class in windows 8.1
PC autoplay is not supported for this device class in windows 8. autoplay is not supported for this device class in windows 8.1
Kartu pintar autoplay is not supported for this device class in windows 8. autoplay is supported for this device class in windows 8.1
Port umum autoplay is not supported for this device class in windows 8. autoplay is supported for this device class in windows 8.1
Perangkat Bluetooth autoplay is not supported for this device class in windows 8. autoplay is not supported for this device class in windows 8.1

Sebelum Anda mulai

  • Pastikan Anda memiliki Wizard Penulisan Metadata Perangkat. Anda akan memerlukannya untuk mengaktifkan AutoPlay. Dalam rilis ini, wizard ini disertakan dengan Microsoft Visual Studio Professional dan Microsoft Visual Studio Ultimate. Tetapi jika Anda memiliki Microsoft Visual Studio Express untuk Windows, Anda perlu mengunduh SDK mandiri untuk Windows 8.1 untuk mendapatkan wizard.

  • Kaitkan aplikasi Anda dengan Microsoft Store. Anda memerlukan informasi paket aplikasi untuk mengaktifkan AutoPlay. Untuk informasi selengkapnya, lihat bagian Mengaitkan aplikasi Anda dengan Microsoft Store di Langkah 1: Membuat aplikasi perangkat UWP.

  • Buat metadata perangkat. Jika Anda belum memulainya, lihat Langkah 2: Membuat metadata perangkat di panduan langkah demi langkah Membangun aplikasi perangkat UWP.

Mengaktifkan Pemutaran Otomatis

Wizard Penulisan Metadata Perangkat memungkinkan Anda mendeklarasikan aplikasi UWP Anda sebagai penangan AutoPlay default untuk perangkat Anda. Anda juga dapat mengizinkan aplikasi UWP lain bertindak sebagai penangan AutoPlay untuk perangkat Anda. Anda dapat memilih salah satu opsi ini atau kedua opsi ini.

Untuk mengaktifkan AutoPlay dengan Wizard Penulisan Metadata Perangkat**

  1. Mulai Wizard Penulisan Metadata Perangkat dari %ProgramFiles(x86)%\Windows Kits\8.1\bin\x86, dengan mengklik dua kali DeviceMetadataWizard.exe.

  2. Klik Edit Metadata Perangkat. Ini akan memungkinkan Anda mengedit paket metadata perangkat yang ada.

  3. Dalam kotak dialog Buka , temukan paket metadata perangkat yang terkait dengan aplikasi perangkat UWP Anda. (Ini memiliki ekstensi file devicemetadata-ms .)

  4. (Opsional.) Jika Anda tidak memiliki nama Paket, Nama penerbit, dan ID Aplikasi aplikasi perangkat, klik Info Aplikasi untuk melihat informasi kemasan untuk aplikasi perangkat UWP Anda.

  5. Klik Info Windows untuk menentukan detail AutoPlay.

  6. Jika Anda ingin menentukan aplikasi untuk menjadi handler AutoPlay default untuk perangkat Anda, pilih Gunakan aplikasi perangkat UWP. Anda dapat memilih aplikasi UWP atau aplikasi perangkat UWP apa pun, tetapi aplikasi tersebut harus menangani aktivasi AutoPlay untuk perangkat Anda dan menentukan ID pengalaman yang sesuai dalam manifes paket aplikasi (seperti yang ditentukan dalam prosedur berikutnya).

    • Nama paket: Dalam manifes paket aplikasi, ini adalah atribut Nama dari elemen Identitas.

    • Nama penerbit: Dalam manifes paket aplikasi, ini adalah atribut Penerbit dari elemen Identitas.

    • ID Aplikasi: Dalam manifes paket aplikasi, ini adalah atribut ID dari elemen Aplikasi.

    • Kata kerja: Ini adalah pengidentifikasi untuk aktivasi AutoPlay. Aplikasi Anda akan menggunakannya untuk menentukan apakah aktivasi berasal dari perangkat Anda. Anda dapat menggunakan nilai apa pun untuk pengaturan Kata Kerja, kecuali untuk terbuka, yang dicadangkan.

    • Jenis peristiwa AutoPlay: Biarkan ini sebagai Perangkat. Dalam metadata perangkat, wizard akan secara otomatis menentukan ID pengalaman yang terkait dengan aplikasi perangkat UWP Anda.

  7. Jika Anda ingin mengizinkan aplikasi lain bertindak sebagai penangan AutoPlay untuk perangkat Anda, pilih Aktifkan AutoPlay untuk aplikasi terdaftar.

  8. Setelah selesai, klik Berikutnya.

  9. Saat Anda melihat halaman Selesai, tulis ID Pengalaman. Anda akan membutuhkannya di prosedur berikutnya, saat menangani aktivasi AutoPlay di aplikasi Anda.

  10. Verifikasi informasi Simpan Anda dan klik Simpan untuk memperbarui paket metadata perangkat Anda.

Menangani aktivasi Pemutaran Otomatis

Untuk menangani aktivasi AutoPlay di aplikasi, Anda perlu mendaftar untuk windows.autoPlayDevice ekstensi dalam manifes paket aplikasi lalu menangani peristiwa tersebut jika OnActivated terjadi objek Aplikasi. Perhatikan bahwa aplikasi Anda dapat mendaftar sebagai handler AutoPlay untuk beberapa perangkat.

Untuk mendaftarkan aplikasi Anda sebagai handler AutoPlay

Untuk mendaftarkan aplikasi Anda sebagai handler AutoPlay untuk perangkat, Anda perlu menentukan ID pengalaman yang terkait dengan aplikasi perangkat UWP Anda dan AutoPlay Verb dan ActionDisplayName yang akan digunakan untuk mengaktifkan aplikasi Anda.

  1. Buka proyek aplikasi Anda di Microsoft Visual Studio.

  2. Di Penjelajah Solusi, klik kanan file Package.appxmanifest dan pilih Tampilkan Kode. Ini akan menampilkan manifes paket aplikasi di Editor XML (Teks).

  3. Application Dalam elemen , di bawah VisualElements elemen , tempelkan elemen berikut Extensions ke dalam file manifes paket Anda.

          <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. Ganti nilai AutoPlay dari contoh ini dengan nilai aktual untuk aplikasi Anda:

    • Verb: Ini adalah pengidentifikasi untuk aktivasi AutoPlay. Aplikasi Anda akan menggunakannya untuk menentukan apakah aktivasi berasal dari perangkat Anda. Jika aplikasi Anda ditentukan sebagai handler AutoPlay default untuk perangkat Anda, nilai ini harus cocok dengan Kata Kerja yang Anda tentukan dalam metadata perangkat. Jika aplikasi Anda tidak ditentukan sebagai handler AutoPlay default untuk perangkat Anda, Anda dapat menggunakan nilai apa pun untuk pengaturan Kata Kerja, kecuali untuk buka, yang dicadangkan.

    • ActionDisplayName: String yang ditampilkan AutoPlay untuk aplikasi Anda.

    • Experience ID: GUID ID pengalaman yang mengaitkan aplikasi Anda dengan perangkat Anda. Ini adalah nilai yang Anda tuliskan dalam prosedur sebelumnya.

Untuk menangani aktivasi AutoPlay

Ketika perangkat Anda memicu aktivasi AutoPlay, jenis aktivasi akan menjadi Windows.ApplicationModel.Activation.ActivationKind.device. Gunakan objek yang diteruskan eventObj OnActivated untuk memeriksa bagaimana aplikasi Anda diaktifkan. Jika berasal dari AutoPlay, Anda dapat menggunakan eventObj untuk menentukan ID perangkat dan kata kerja AutoPlay mana yang menyebabkan aktivasi.

Dalam contoh ini, parameter peristiwa aktivasi (eventObj) membawa ID perangkat serta kata kerja untuk aktivasi.

<!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>

Memenuhi aplikasi perangkat UWP

Membangun aplikasi perangkat UWP langkah demi langkah

Peluncuran otomatis dengan AutoPlay

Meluncurkan, melanjutkan, dan multitugas