Inicio rápido: configurar almacenamiento extraíble como dispositivo de Reproducción automática (HTML)
[ Este artículo está destinado a desarrolladores de Windows 8.x y Windows Phone 8.x que escriben aplicaciones de Windows en tiempo de ejecución. Si estás desarrollando para Windows 10, consulta la documentación más reciente
Puedes identificar un dispositivo de volumen, como una tarjeta de memoria o una unidad USB, como dispositivo de Reproducción automática cuando el dispositivo de volumen se conecte al equipo. Esto es particularmente útil cuando deseas asociar una aplicación específica para la Reproducción automática para el dispositivo de volumen.
Aquí se muestra cómo identificar el dispositivo de volumen como dispositivo de Reproducción automática.
Para identificar el dispositivo de volumen como dispositivo de Reproducción automática, agrega un archivo autorun.inf a la unidad raíz del dispositivo. En el archivo autorun.inf, agrega una clave CustomEvent a la sección AutoRun. Cuando el dispositivo de volumen se conecte a un equipo, Reproducción automática encontrará el archivo autorun.inf y tratará el volumen como un dispositivo. Reproducción automática creará un evento de Reproducción automática con el nombre que proporcionaste para la clave CustomEvent. Después podrás crear una aplicación y registrarla como controlador del evento de Reproducción automática. Cuando se conecte el dispositivo al equipo, Reproducción automática mostrará la aplicación como controlador del dispositivo de volumen. Para obtener más información acerca de los archivos autorun.inf, consulta Entradas de autorun.inf.
Fabricantes de dispositivos:: Reproducción automática no descarga automáticamente la aplicación que creas como un controlador de tu dispositivo. Pero, como siempre, los usuarios pueden obtener la aplicación de la Tienda Windows. Para crear una experiencia más optimizada, usa los metadatos del dispositivo para asociar la aplicación a tu dispositivo. Si asocias la aplicación como una aplicación de instalación automática para la identificación de tu dispositivo, el sistema operativo detectará la asociación cuando el dispositivo se conecte a un equipo. Si el equipo no tiene instalada la aplicación, el sistema operativo la descargará e instalará automáticamente. Reproducción automática presentará la aplicación como primera opción para que el usuario elija como controlador del dispositivo. Para obtener más información, consulta el tema sobre la Reproducción automática de aplicaciones para dispositivo de la Tienda Windows.
Objetivo: Crea una aplicación para controlar un evento personalizado de Reproducción automática para un dispositivo de volumen.
Requisitos previos
Debes tener un dispositivo de volumen, como una unidad USB o una tarjeta de memoria, para completar las instrucciones de este Inicio rápido.
Microsoft Visual Studio
Instrucciones
1. Crear un archivo autorun.inf
En la unidad raíz del dispositivo de volumen, agrega un archivo denominado autorun.inf. Abre el archivo autorun.inf y agrega el siguiente texto.
[AutoRun] CustomEvent=AutoPlayCustomEventQuickstart
2. Crear un nuevo proyecto y agregar declaraciones de Reproducción automática
Abre Visual Studio y selecciona Nuevo proyecto en el menú Archivo. En la sección Javascript, selecciona Tienda Windows. Asigna el nombre AutoPlayCustomEvent a la aplicación y haz clic en Aceptar.
Abre el archivo Package.appxmanifest y selecciona la pestaña Capacidades. Selecciona la funcionalidad Almacenamiento extraíble. Esto permite que la aplicación tenga acceso a los archivos y carpetas de los dispositivos de almacenamiento extraíble.
En el archivo de manifiesto, selecciona la pestaña Declaraciones. En la lista desplegable Declaraciones disponibles, selecciona Contenido de Reproducción automática y después haz clic en Agregar. Selecciona el elemento Contenido de Reproducción automática que se agregó a la lista Declaraciones admitidas.
Nota También puedes elegir agregar una declaración de Dispositivo de Reproducción automática para el evento de Reproducción automática personalizado.
En la sección Acciones de inicio de tu declaración de evento de contenido de Reproducción automática, especifica los siguientes valores para la primera acción de inicio.
Configuración Valor Verbo show Nombre para mostrar de la acción Mostrar carpetas Evento de contenido AutoPlayCustomEventQuickstart El valor Evento de contenido es el texto que suministraste para la clave CustomEvent en el archivo autorun.inf. La configuración Nombre para mostrar de la acción identifica la cadena que Reproducción automática muestra para tu aplicación. La configuración Verbo identifica un valor que se pasa a la aplicación para la opción seleccionada. Puedes especificar varias acciones de inicio para un evento de Reproducción automática y usar la configuración Verbo para determinar qué opción seleccionó un usuario para tu aplicación. Para saber qué opción seleccionó el usuario, comprueba la propiedad verb de los argumentos del evento de inicio que se pasaron a la aplicación. Puedes usar cualquier valor para la configuración Verbo a excepción de open, que está reservado.
En la lista desplegable Declaraciones disponibles, selecciona Asociaciones de tipo de archivo y haz clic en Agregar. En las propiedades de la declaración Asociaciones de tipo de archivo nueva, establece el campo Nombre para mostrar en Show .ms Files y el campo Nombre en ms_association. En la sección Tipos de archivo admitidos, haz clic en Agregar nuevo. Establece el campo Tipo de archivo en .ms. Para los eventos de contenido, Reproducción automática filtra todos los tipos de archivo que no están asociados explícitamente a la aplicación.
Guarda y cierra el archivo de manifiesto.
3. Agregar interfaz de usuario HTML
Abre el archivo Default.html y coloca el siguiente código HTML en la sección <body>.
<h2>Files</h2> <div id="files" style="width:400px;height:600px;font-size:large;" />
4. Agregar código de activación
El código de este paso llama a una función para que muestre las carpetas en la unidad raíz del dispositivo de volumen. Para los eventos de contenido de Reproducción automática, Reproducción automática transmite la carpeta raíz del dispositivo de almacenamiento en los argumentos de inicio que se transmiten a la aplicación. Puedes recuperar esta carpeta del primer elemento de la propiedad detail.files. Se puede ver que la aplicación se inició como un controlador para un evento de contenido de Reproducción automática si la propiedad detail.kind de los argumentos de evento de activación devuelve un valor de Windows.ApplicationModel.Activation.ActivationKind.file.
Abre la carpeta js. Abre el archivo Default.js y reemplaza la función onactivated predeterminada con el siguiente código.
var filesDiv; app.onactivated = function (args) { if (args.detail.kind === activation.ActivationKind.file) { filesDiv = document.getElementById("files"); displayFiles(args.detail.files[0]); } args.setPromise(WinJS.UI.processAll()); };
5. Agregar código para mostrar nombres de imágenes
En el archivo Default.js, agrega el siguiente código después de la función onactivated.
function displayFiles(folder) { var options = new Windows.Storage.Search.QueryOptions(); options.fileTypeFilter.append(".ms"); var query = folder.createFileQueryWithOptions(options); query.getFilesAsync().done( function (files) { files.forEach( function (f) { filesDiv.innerHTML += " " + f.name + "<br/>"; }); }); }
6. Compilar y ejecutar la aplicación
- Presiona F5 para compilar e implementar la aplicación (en modo de depuración).
- Para ejecutar la aplicación, inserta una tarjeta de memoria u otro dispositivo de almacenamiento en el equipo. Luego, selecciona la aplicación en la lista de opciones de controlador de Reproducción automática.
Resumen y siguientes pasos
En este tutorial has identificado un dispositivo de volumen como dispositivo de Reproducción automática mediante la definición de un nombre de evento de Reproducción automática con un archivo autorun.inf. Después has creado una aplicación que se registra como controlador de ese evento personalizado.