Автозапуск для UWP-приложений

Производители устройств могут указать свое приложение устройства UWP в качестве обработчика автозапуска для своего устройства. Они также могут позволить другим приложениям UWP выступать в качестве обработчиков автозапуска для своего устройства. В этой статье описывается, как использовать мастер разработки метаданных устройства для включения автозапуска. В нем также описывается обработка активаций Автозапуска в приложении. Дополнительные сведения о приложениях устройств см. в статье "Знакомство с приложениями устройств UWP".

Для всех типов автозапуска не требуется использовать метаданные устройства. Без метаданных устройства автозапуск позволяет предоставить приложение в качестве параметра, когда пользователь подключает устройство к компьютеру. Эти устройства бывают без хранения данных, такие как камера или проигрыватель мультимедиа, или устройства хранения данных, такие как USB-диск, SD-карта или DVD-диск. Автозапуск также позволяет зарегистрировать ваше приложение в качестве варианта, когда пользователи обмениваются файлами между двумя устройствами с помощью функции ближнего взаимодействия (касание). Но приложение не может устанавливаться автоматически без метаданных устройства. Дополнительные сведения об использовании автозапуска, если метаданные устройства не требуются, см. в статье "Автоматическое запуск с помощью автозапуска".

Обзор автозапуска

В зависимости от версии приложения можно включить автозапуск следующим образом:

• Только ваше приложение для устройства UWP может обрабатывать активацию автозапуска для вашего устройства (поддерживается в Windows 8, Windows 8.1).
• Другие приложения UWP могут обрабатывать активацию AutoPlay для вашего устройства (только в Windows 8.1).
• Приложения устройства UWP и другие приложения UWP могут обрабатывать активацию функции автозапуска для вашего устройства (поддерживается только в Windows 8.1).

В этом примере показано диалоговое окно автозапуска для приложения с именем Contoso Dashboard , зарегистрированное в качестве обработчика автозапуска для устройства Contoso Pedometer :

AutoPlay поддерживает эти типы устройств при использовании метаданных устройства с приложением:

Класс устройства	Автовоспроизведение поддерживается в Windows 8	В Windows 8.1 поддерживается функция автозапуска.
Цифровая фотокамера
Цифровая видеокамера
Переносимый проигрыватель мультимедиа
Сотовый телефон
Мобильное широкополосное подключение
Веб-камера
Устройство пользовательского интерфейса (HID)
Принтеры, сканеры, факс
ПК
Смарт-карта
Общий порт
Устройство Bluetooth

Перед тем как начать

• Убедитесь, что у вас есть мастер разработки метаданных устройства. Вам необходимо включить автозапуск. В этом выпуске этот мастер входит в состав Microsoft Visual Studio Professional и Microsoft Visual Studio Ultimate. Но если у вас есть Microsoft Visual Studio Express для Windows, необходимо скачать автономный пакет SDK для Windows 8.1, чтобы использовать мастер установки.

• Свяжите приложение с Microsoft Store. Чтобы включить автозапуск, вам потребуются сведения о пакете приложения. Дополнительные сведения см. в разделе "Связывание приложения с Microsoft Store" в шаге 1. Создание приложения устройства UWP.

• Создайте метаданные устройства. Дополнительные сведения см. в шаге 2. Создание метаданных устройства в пошаговом руководстве по созданию приложения устройства UWP .

Включение автозапуска

Мастер разработки метаданных устройств позволяет объявить приложение UWP обработчиком автозапуска по умолчанию для устройства. Вы также можете разрешить другим приложениям UWP выступать в качестве обработчиков автозапуска для вашего устройства. Вы можете выбрать один из этих вариантов или оба из этих параметров.

Чтобы включить Автозапуск с помощью мастера создания метаданных устройства**

1. Запустите Мастер разработки метаданных устройства из %ProgramFiles(x86)%\Windows Kits\8.1\bin\x86, дважды кликнув DeviceMetadataWizard.exe.

2. Чтобы изменить существующий пакет метаданных устройства, выберите "Изменить метаданные устройства".

3. В диалоговом окне "Открыть" найдите пакет метаданных устройства, связанный с приложением устройства UWP. (Он имеет расширение файла devicemetadata-ms .)

4. (Необязательно.) Если у вас нет под рукой имени пакета приложения, имени издателя и идентификатора приложения устройства, выберите Информация о приложении, чтобы просмотреть сведения о упаковке для вашего приложения устройства UWP.

5. Выберите Windows Info, чтобы указать сведения об автовоспроизведении.

6. Если вы хотите указать приложение, которое будет обработчиком автозапуска по умолчанию для устройства, выберите "Использовать приложение устройства UWP". Вы можете выбрать любое приложение UWP или приложение устройства UWP. Однако это приложение должно обеспечивать работу функции автозапуска для вашего устройства. Приложение также должно указать соответствующий идентификатор интерфейса в манифесте пакета приложения (как указано в следующей процедуре).

   • Имя пакета: В манифесте пакета приложения имя пакета является атрибутом Name элемента Identity.

   • Имя издателя: в манифесте пакета приложения имя издателя — атрибут Publisher элемента Identity.

   • Идентификатор приложения. В манифесте пакета приложения идентификатор приложения — это атрибут идентификатора элемента Application.

   • Глагол: Глагол — это идентификатор активации автозапуска. Приложение использует его для определения того, была ли активация получена с устройства. Для параметра Verb можно использовать любое значение, за исключением open, которое зарезервировано для специального использования.

   • Тип события автозапуска: оставьте это поле установленным на значение Устройство. В метаданных устройства мастер автоматически задает идентификатор интерфейса, связанный с приложением устройства UWP.

7. Если вы хотите разрешить другим приложениям выступать в качестве обработчиков автозапуска для устройства, выберите "Включить автозапуск" для зарегистрированных приложений.

8. Когда все будет готово, нажмите кнопку Далее.

9. Когда вы увидите страницу Готово, запишите идентификатор опыта. Это потребуется в следующей процедуре при обработке активации автозапуска в приложении.

10. Проверьте сведения о сохранении и нажмите кнопку "Сохранить ", чтобы обновить пакет метаданных устройства.

Обработка активации автозапуска

Чтобы обработать активацию функции AutoPlay в вашем приложении, зарегистрируйте расширение windows.autoPlayDevice в манифесте пакета приложения. Затем обработайте это событие в событии OnActivated объекта Application. Ваше приложение может быть зарегистрировано в качестве обработчика автозапуска для нескольких устройств.

Регистрация приложения в качестве обработчика автозапуска

Чтобы зарегистрировать приложение в качестве обработчика автозапуска для устройства, укажите идентификатор опыта, связанный с вашим приложением устройства UWP, глагол автозапуска и ActionDisplayName, используемые для активации вашего приложения.

1. Откройте проект приложения в Microsoft Visual Studio.

2. В обозревателе решений щелкните правой кнопкой мыши файл Package.appxmanifest и выберите команду View Code. Этот параметр отображает манифест пакета приложения в редакторе 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, за исключением open, который зарезервирован.

   • ActionDisplayName: строка, которую AutoPlay отображает для вашего приложения.

   • Experience ID: ИДЕНТИФИКАТОР интерфейса, который связывает приложение с вашим устройством. Этот GUID — значение, записанное в предыдущей процедуре.

Обработка активации автозапуска

Когда на вашем устройстве активируется функция AutoPlay, тип активации — это Windows.ApplicationModel.Activation.ActivationKind.device. Чтобы проверить, как было активировано ваше приложение, используйте объект eventObj, переданный OnActivated. Если это было из автозапуска, можно использовать eventObj для определения идентификатора устройства и команды автозапуска, вызвавшей активацию.

В этом примере параметр события активации (eventObj) содержит идентификатор устройства и команду для активации.

<!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
• Автоматический запуск с помощью функции AutoPlay
• Запуск, Возобновление и Многозадачность