Office.DevicePermissionType enum
Spécifie la fonctionnalité d’appareil à laquelle un complément demande l’accès.
Remarques
Applications : cette API est prise en charge par les applications Office suivantes lorsqu’elles s’exécutent dans des navigateurs basés sur Chromium, tels que Microsoft Edge et Google Chrome.
Excel sur le web
Outlook sur le web
PowerPoint sur le web
Word sur le web
Il est également pris en charge dans la nouvelle version d’Outlook sur Windows (préversion).
Ensemble de conditions requises : DevicePermission 1.1
Exemples
// Request permission from a user to access their device capabilities.
const host = Office.context.host;
if (host === Office.HostType.Excel || host === Office.HostType.PowerPoint || host === Office.HostType.Word) {
if (Office.context.platform === Office.PlatformType.OfficeOnline) {
const deviceCapabilities = [
Office.DevicePermissionType.camera,
Office.DevicePermissionType.microphone
];
Office.devicePermission
.requestPermissions(deviceCapabilities)
.then((isGranted) => {
if (isGranted) {
console.log("Permission granted.");
// Do something when permission is granted.
} else {
console.log("Permission denied.");
// Do something when permission is denied.
}
});
}
} else if (host === Office.HostType.Outlook) {
if (Office.context.mailbox.diagnostics.hostName === "OutlookWebApp") {
const deviceCapabilities = [
Office.DevicePermissionType.camera,
Office.DevicePermissionType.geolocation,
Office.DevicePermissionType.microphone
];
Office.devicePermission.requestPermissionsAsync(deviceCapabilities, (asyncResult) => {
if (asyncResult.status === Office.AsyncResultStatus.Failed) {
console.log (asyncResult.error.message);
return;
}
if (asyncResult.value) {
console.log("Permission granted.");
// Do something when permission is granted.
} else {
console.log("Permission denied.");
// Do something when permission is denied.
}
});
}
} else {
console.log("The add-in isn't running in Excel, Outlook, PowerPoint, or Word.");
}
Champs
camera | Le complément demande l’accès à la caméra de l’utilisateur. |
geolocation | Le complément demande l’accès à la géolocalisation de l’utilisateur. Important : l’accès à la géolocalisation d’un utilisateur n’est pris en charge que dans Outlook sur le web et outlook sur Windows (préversion). |
microphone | Le complément demande l’accès au microphone de l’utilisateur. |
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour