Reproducción automática de aplicaciones de dispositivos para UWP

Los fabricantes de dispositivos pueden especificar su aplicación de dispositivo para UWP como un controlador de reproducción automática para su dispositivo. También pueden permitir que otras aplicaciones para UWP actúen como controladores de reproducción automática para su dispositivo. En este tema se describe cómo usar el Asistente para creación de metadatos de dispositivo para habilitar la reproducción automática. También se describe cómo controlar las activaciones de reproducción automática en la aplicación. Para obtener más información sobre las aplicaciones de dispositivos, consulte Conocer las aplicaciones de dispositivos para UWP.

Nota:

No es necesario usar metadatos de dispositivo para todos los tipos de reproducción automática. Sin metadatos de dispositivo, la reproducción automática permite proporcionar la aplicación como opción cuando un usuario conecta un dispositivo a un equipo. Esto incluye dispositivos que no son de volumen, como una cámara o un reproductor multimedia, o dispositivos de volumen, como una unidad USB, una tarjeta SD o un DVD. La reproducción automática también le permite registrar la aplicación como una opción cuando los usuarios comparten archivos entre dos máquinas mediante Proximidad (toque). Pero la aplicación no se puede instalar automáticamente sin metadatos del dispositivo. Para obtener más información sobre el uso de la reproducción automática cuando no se requieren metadatos del dispositivo, consulte Inicio automático con reproducción automática.

Introducción a la reproducción automática

En función de la versión de la aplicación, puede habilitar la reproducción automática de estas maneras:

• Solo la aplicación de dispositivo para UWP puede controlar la activación de la reproducción automática para el dispositivo (compatible con Windows 8, Windows 8.1).

• Otras aplicaciones para UWP pueden controlar la activación de la reproducción automática para el dispositivo (solo se admite en Windows 8.1).

• La aplicación de dispositivo para UWP y otras aplicaciones para UWP pueden controlar la activación de la reproducción automática para el dispositivo (solo compatible con Windows 8.1).

En este ejemplo se muestra un cuadro de diálogo de reproducción automática para una aplicación llamado Panel de Contoso que se ha registrado como controlador de reproducción automática para el dispositivo Podómetro de Contoso:

Al usar metadatos de dispositivo con la aplicación, la reproducción automática admite estos tipos de dispositivo:

Clase de dispositivo	Reproducción automática compatible con Windows 8	Reproducción automática compatible con Windows 8.1
Cámara fotográfica digital
Videocámara digital
Reproductor multimedia portátil
Asignación
Banda ancha móvil
Cámara web
Dispositivo de interfaz humana (HID)
Impresoras, escáneres, fax
PC
Tarjeta inteligente
Puerto general
Dispositivo Bluetooth

Antes de empezar

• Asegúrese de que tiene el Asistente para creación de metadatos de dispositivo. Lo necesitará para habilitar la reproducción automática. En esta versión, este asistente se incluye con Microsoft Visual Studio Professional y Microsoft Visual Studio Ultimate. Pero si tiene Microsoft Visual Studio Express para Windows, debe descargar el SDK independiente para Windows 8.1 para obtener el asistente.

• Asocie la aplicación con Microsoft Store. Necesitará la información del paquete de la aplicación para habilitar la reproducción automática. Para obtener más información, consulte la sección Asociación de la aplicación con Microsoft Store en el Paso 1: Creación de una aplicación de dispositivo para UWP.

• Cree los metadatos del dispositivo. Si aún no lo ha iniciado, consulte el Paso 2: Creación de metadatos de dispositivo en la guía Creación de una aplicación de dispositivo para UWP paso a paso.

Habilitación de la reproducción automática

El Asistente para creación de metadatos de dispositivo le permite declarar que su aplicación para UWP es el controlador de reproducción automática predeterminado para su dispositivo. También pueden permitir que otras aplicaciones para UWP actúen como controladores de reproducción automática para su dispositivo. Puede elegir cualquiera de estas opciones o ambas opciones.

Para habilitar la reproducción automática con el Asistente para creación de metadatos de dispositivo**

1. Inicie el Asistente para creación de metadatos de dispositivo desde %ProgramFiles(x86)%\Windows Kits\8.1\bin\x86, haciendo doble clic en DeviceMetadataWizard.exe.

2. Haga clic en Editar metadatos del dispositivo. Esto le permitirá editar el paquete de metadatos del dispositivo existente.

3. En el cuadro de diálogo Abrir, busque el paquete de metadatos del dispositivo asociado a la aplicación de dispositivo para UWP. (Tiene una extensión de archivo devicemetadata-ms).

4. (Opcional). Si no tiene a mano el nombre del paquete de la aplicación de dispositivo, el nombre del publicador y el identificador de aplicación, haga clic en Información de la aplicación para ver la información de empaquetado de su aplicación de dispositivo para UWP.

5. Haga clic en Información de Windows para especificar los detalles de reproducción automática.

6. Si desea especificar una aplicación para que sea el controlador de reproducción automática predeterminado para su dispositivo, seleccione Usar una aplicación de dispositivo para UWP. Puedes seleccionar cualquier aplicación para UWP o aplicación de dispositivo para UWP, pero esa aplicación debe controlar la activación de la reproducción automática del dispositivo y especificar el identificador de experiencia correspondiente en el manifiesto del paquete de la aplicación (como se especifica en el procedimiento siguiente).

   • Nombre del paquete: en el manifiesto del paquete de la aplicación, este es el atributo Name del elemento Identity.

   • Nombre del publicador: en el manifiesto del paquete de la aplicación, este es el atributo Publisher del elemento Identity.

   • Identificador de aplicación: en el manifiesto del paquete de aplicación, este es el atributo ID del elemento Application.

   • Verbo: es el identificador de la activación de la reproducción automática. La aplicación lo usará para determinar si la activación procede del dispositivo. Puede usar cualquier valor para la opción de configuración de Verbo, a excepción de abrir, que está reservado.

   • Tipo de evento de reproducción automática: déjelo como Dispositivo. En los metadatos del dispositivo, el asistente especificará automáticamente el identificador de experiencia asociado a la aplicación de dispositivo para UWP.

7. Si quiere permitir que otras aplicaciones actúen como controladores de reproducción automática para el dispositivo, seleccione Habilitar reproducción automática para las aplicaciones registradas.

8. Cuando haya terminado, haga clic en Siguiente.

9. Cuando vea la página Finalizar, anote el Identificador de experiencia. Lo necesitará en el siguiente procedimiento, cuando controle la activación de la reproducción automática en la aplicación.

10. Compruebe la información de guardado y haga clic en Guardar para actualizar el paquete de metadatos del dispositivo.

Control de la activación de reproducción automática

Para controlar una activación de reproducción automática en la aplicación, debe registrarse para obtener una extensión windows.autoPlayDevice en el manifiesto del paquete de la aplicación y, a continuación, controlar ese evento en el evento OnActivated del objeto de la aplicación. Tenga en cuenta que la aplicación puede registrarse como un controlador de reproducción automática para varios dispositivos.

Para registrar la aplicación como un controlador de reproducción automática

Para registrar la aplicación como controlador de reproducción automática para el dispositivo, debe especificar el identificador de experiencia asociado a su aplicación de dispositivo para UWP y el Verbo y ActionDisplayName de reproducción automática que se usarán para activar la aplicación.

1. Abra el proyecto de la aplicación en Microsoft Visual Studio.

2. En el Explorador de soluciones, haga clic con el botón derecho en el archivo Package.appxmanifest y seleccione Ver código. Esto mostrará el manifiesto del paquete de aplicación en el Editor XML (texto).

3. En el elemento Application, debajo del elemento VisualElements, pegue el siguiente elemento Extensions en el archivo de manifiesto del paquete.

         <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. Reemplace los valores de reproducción automática de este ejemplo por los valores reales de la aplicación:

   • Verb: es el identificador de la activación de reproducción automática. La aplicación lo usará para determinar si la activación procede del dispositivo. Si la aplicación se especificó como controlador de reproducción automática predeterminado para el dispositivo, este valor debe coincidir con el Verbo que especificó en los metadatos del dispositivo. Si la aplicación no se especificó como controlador de reproducción automática predeterminado para el dispositivo, puede usar cualquier valor para la configuración de Verbo, excepto para abrir, que está reservado.

   • ActionDisplayName: la cadena que muestra la reproducción automática para la aplicación.

   • Experience ID: el GUID del identificador de experiencia que asocia la aplicación con el dispositivo. Este es el valor que anotó en el procedimiento anterior.

Para controlar la activación de la reproducción automática

Cuando el dispositivo desencadena una activación de reproducción automática, el tipo de activación será Windows.ApplicationModel.Activation.ActivationKind.device. Use el objeto eventObj transferido por OnActivated para comprobar cómo se ha activado la aplicación. Si se trata de reproducción automática, puede usar eventObj para determinar qué identificador de dispositivo y verbo de reproducción automática provocaron la activación.

En este ejemplo, el parámetro de evento de activación (eventObj) lleva el identificador del dispositivo, así como el verbo para la activación.

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

Temas relacionados

Conocer las aplicaciones de dispositivos para UWP

Creación de una aplicación de dispositivo para UWP paso a paso

Inicio automático con Reproducción automática

Launching, resuming, and multitasking