Office.DevicePermissionType enum
Gibt die Gerätefunktion an, auf die ein Add-In Zugriff anfordert.
Hinweise
Anwendungen: Diese API wird von den folgenden Office-Anwendungen unterstützt, wenn sie in Chromium-basierten Browsern wie Microsoft Edge und Google Chrome ausgeführt wird.
Excel im Web
Outlook im Web
PowerPoint im Web
Word im Web
Es wird auch im neuen Outlook unter Windows (Vorschauversion) unterstützt.
Anforderungssatz: DevicePermission 1.1
Beispiele
// 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.");
}
Felder
camera | Das Add-In fordert Zugriff auf die Kamera des Benutzers an. |
geolocation | Das Add-In fordert Zugriff auf den geografischen Standort des Benutzers an. Wichtig: Der Zugriff auf die Geolocation eines Benutzers wird nur in Outlook im Web und dem neuen Outlook unter Windows (Vorschau) unterstützt. |
microphone | Das Add-In fordert Zugriff auf das Mikrofon des Benutzers an. |
Office Add-ins
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für