Cómo obtener notificaciones si se agregan, se quitan o se modifican dispositivos (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
En este tutorial verás cómo enumerar dispositivos de manera dinámica. A continuación, tu aplicación podrá recibir notificaciones si se agregan o se quitan dispositivos o si se cambian las propiedades de los dispositivos.
Para iniciar una enumeración de dispositivos, tienes que usar la clase DeviceWatcher. Por cada dispositivo encontrado, DeviceWatcher genera un evento Add hasta que se encuentran todos los dispositivos y se completa la enumeración. Tras completarse la enumeración inicial, DeviceWatcher sigue generando eventos si se agrega, se actualiza o se quita un dispositivo.
Lo que debes saber
Tecnologías
- Windows Runtime
Requisitos previos
JavaScript y HTML.
Instrucciones
Paso 1: Abrir Microsoft Visual Studio
Abre una instancia de Visual Studio.
Paso 2: Crear un nuevo proyecto
En el cuadro de diálogo Nuevo proyecto, en los tipos de proyecto JavaScript > Aplicaciones de la Tienda Windows, elige una aplicación vacía.
Paso 3: insertar el código JavaScript y HTML de la aplicación
Abre el archivo Default.html y copia el código HTML siguiente, sustituyendo su contenido original.
<!DOCTYPE html>
<html>
<head>
<title>Device Enumeration Sample</title>
<meta charset="utf-8" />
<script src="/js/default.js"></script>
</head>
<body role="application">
<h1>Device Enumeration Sample</h1>
<h2 >Input</h2>
<div >
<div >
<p>This example incrementally enumerates devices, adding them to a list each time a device is found, and also watching for updates.
Once enumeration is complete, the list of devices is printed.</p>
<input type="button" value="Watch(All Devices)" onclick="WatchDevices()"/>
<br /><br />
<input type="button" value="Stop" onclick="stopWatcher()"/>
<br /><br />
</div>
</div>
<h2 > Output</h2>
<div id="statusMessage"></div>
<!-- Output -->
<div id="output"></div>
</body>
</html>
Paso 4:
Pega este contenido en default.js, sustituyendo el contenido del archivo.
var watcher;
var isEnumerationComplete = false;
var deviceArray = new Array(); // Saves the enumeration results
function WatchDevices() {
try {
output.innerHTML = ""; // clear output field
watcher =
Windows.Devices.Enumeration.DeviceInformation.createWatcher();
// Add event handlers
watcher.addEventListener("added", onAdded);
watcher.addEventListener("removed", onRemoved);
watcher.addEventListener("updated", onUpdated);
watcher.addEventListener("enumerationcompleted",
onEnumerationCompleted);
watcher.addEventListener("stopped", onStopped);
// Start enumerating and listening for events
watcher.start();
} catch (e) {
document.getElementById("statusMessage").innerHTML =
"Failed to create watcher, error: " + e.message;
}
}
function stopWatcher() {
try {
watcher.stop();
}
catch (e) {
document.getElementById("statusMessage").innerHTML =
"Failed to stop watcher: " + e.message;
}
}
function onAdded(devinfo) {
document.getElementById("output").innerHTML += "<p>Device added: " +
devinfo.name + "</p>";
deviceArray.push(devinfo);
if (isEnumerationComplete) {
output.innerHTML = ""; // clear output field
printDeviceArray(document.getElementById("output"));
}
}
function onUpdated(devUpdate) {
document.getElementById("output").innerHTML += "<p>Device updated.</p>";
for (var i = 0; i < deviceArray.length; i++) {
if (deviceArray[i].id == devUpdate.id) {
deviceArray[i].update(devUpdate);
}
}
output.innerHTML = ""; // clear output field
printDeviceArray(document.getElementById("output"));
}
function onRemoved(devupdate) {
document.getElementById("output").innerHTML += "<p>Device removed.</p>";
for (var i = 0; i < deviceArray.length; i++) {
if (deviceArray[i].id == devupdate.id) {
deviceArray[i].slice(devupdate);
}
}
output.innerHTML = ""; // clear output field
printDeviceArray(document.getElementById("output"));
}
function onEnumerationCompleted(obj) {
isEnumerationComplete = true;
document.getElementById("output").innerHTML +=
"<p>Enumeration Completed.</p>";
printDeviceArray(document.getElementById("output"));
}
function onStopped(obj) {
document.getElementById("output").innerHTML += "<p>Stopped.</p>";
if (watcher.status == Windows.Devices.Enumeration.DeviceWatcherStatus.aborted) {
document.getElementById("output").innerHTML +=
"<p>Enumeration stopped unexpectedly. </p>";
document.getElementById("output").innerHTML +=
"<p>Click the Watch button to restart enumeration.</p>";
} else if (watcher.status == Windows.Devices.Enumeration.DeviceWatcherStatus.stopped) {
document.getElementById("output").innerHTML +=
"<p>You requested to stop enumeration. </p>";
document.getElementById("output").innerHTML +=
"<p>Click the Watch button to restart enumeration.</p>";
}
}
// Prints the friendly name of the device interface,
// its ID (device interface path), and whether it is enabled.
function printDevice(deviceInterface, outputDestination) {
outputDestination.innerHTML += "<p>Name: " +
deviceInterface.name + "<p/>";
outputDestination.innerHTML += "<p>Interface ID: " +
deviceInterface.id + "<p/>";
outputDestination.innerHTML += "<p>Enabled: " +
deviceInterface.isEnabled + "<p/>";
outputDestination.innerHTML += "<br />";
}
function printDeviceArray(outputDestination) {
for (var i = 0; i < deviceArray.length; i++) {
printDevice(deviceArray[i], outputDestination);
}
}
Observaciones
En este ejemplo se enumeran dispositivos de manera incremental. Se agregan a una lista cada vez que se encuentra un dispositivo y también se comprueba si hay actualizaciones. Tras completarse la enumeración, la aplicación imprime una lista de dispositivos. La aplicación también imprime un mensaje si un usuario agrega, actualiza o quita dispositivos tras completarse la enumeración inicial.
Nota Una aplicación debe suscribirse a todos los eventos added, removed y updated para recibir una notificación cuando haya adiciones, eliminaciones o actualizaciones de dispositivo. Si una aplicación controla solamente el evento added, no recibirá una actualización si se agrega un dispositivo al sistema después de que se complete la enumeración de dispositivos inicial.