Comment obtenir des notifications si des périphériques sont ajoutés, supprimés ou modifiés (HTML)
[ Cet article est destiné aux développeurs de Windows 8.x et Windows Phone 8.x qui créent des applications Windows Runtime. Si vous développez une application pour Windows 10, voir la Documentation ]
Ce didacticiel vous montre comment énumérer les périphériques de manière dynamique. Votre application peut alors recevoir une notification si les périphériques sont ajoutés ou supprimés, ou si les propriétés du périphérique sont modifiées.
Vous utilisez la classe DeviceWatcher pour démarrer une énumération de périphérique. Pour chaque périphérique détecté, DeviceWatcher déclenche un événement d’ajout jusqu’à ce que tous les périphériques soient détectés et que l’énumération soit terminée. Une fois l’énumération initiale terminée, DeviceWatcher continue de déclencher des événements si un périphérique est ajouté, mis à jour ou supprimé.
Ce que vous devez savoir
Technologies
- Windows Runtime
Prérequis
JavaScript et HTML.
Instructions
Étape 1: Ouvrir Microsoft Visual Studio
Ouvrez une instance de Visual Studio.
Étape 2: Créer un projet
Dans la boîte de dialogue Nouveau projet, dans les types de projets JavaScript > applications du Windows Store, sélectionnez une application vide.
Étape 3: insérer les codes JavaScript et HTML de l’application
Ouvrez le fichier Default.html et copiez-y ce code HTML à la place du contenu d’origine.
<!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>
Étape 4:
Copiez ce code dans default.js, en remplaçant le contenu du fichier.
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);
}
}
Remarques
Cet exemple énumère les périphériques de manière incrémentielle. Il les ajoute à la liste chaque fois qu’un périphérique est détecté et surveille également les mises à jour. Une fois l’énumération terminée, l’application affiche une liste de périphériques. L’application affiche également un message si un utilisateur ajoute, modifie ou supprime des périphériques à l’issue de l’énumération initiale.
Remarque Une application doit être abonnée à tous les événements added, removed et updated pour être notifiée quand des périphériques sont ajoutés, supprimés ou mis à jour. Si une application gère uniquement l’événement added, elle ne recevra pas de mise à jour si un périphérique est ajouté au système à l’issue de l’énumération du périphérique initial.