Anfordern von Geräte Berechtigungen für Ihre Microsoft Teams-RegisterkarteRequest device permissions for your Microsoft Teams tab

Möglicherweise möchten Sie die Registerkarte mit Features erweitern, die den Zugriff auf systemeigene Gerätefunktionen erfordern, wie:You might want to enrich your tab with features that require access native device functionality like:

  • KameraCamera
  • MikrofonMicrophone
  • StandortLocation
  • BenachrichtigungenNotifications

Wichtig

  • Derzeit unterstützt der Mobile Microsoft Teams camera -Client nur und location über systemeigene Gerätefunktionen und steht in allen APP-Konstrukten einschließlich Registerkarten zur Verfügung.Currently, Teams mobile client only supports camera and location through native device capabilities and is available on all app constructs including tabs.
  • Die Unterstützung für camera die Bildaufnahme wird von der captureImage-APIaktiviert.Support for camera image capture is enabled by the captureImage API.
  • Die Geolocation-API wird derzeit nicht vollständig auf allen Desktop-Clients unterstützt.The geolocation API is currently not fully supported on all desktop clients.

GeräteberechtigungenDevice permissions

Wenn Sie auf die Geräte Berechtigungen eines Benutzers zugreifen, können Sie viel umfassendere Erfahrungen sammeln, beispielsweise:Accessing a user’s device permissions allows you to build much richer experiences, for example:

  • Aufzeichnen und Freigeben von kurzen VideosRecord and share short videos
  • Kurze audiomemos aufzeichnen und später speichernRecord short audio memos and save them for later
  • Verwenden von Benutzerstandort Informationen zum Anzeigen relevanter InformationenUse user location information to display relevant information

Während der Zugriff auf diese Funktionen in den meisten modernen Webbrowsern standardmäßig ist, müssen Sie Microsoft Teams mitteilen, welche Funktionen Sie verwenden möchten, indem Sie Ihr App-Manifest aktualisieren.While access to these features are standard in most modern web browsers, you need to let Teams know which features you’d like to use by updating your app manifest. Auf diese Weise können Sie Berechtigungen wie in einem Browser anfordern, während Ihre APP auf dem Desktop-Client von Teams läuft.This will allow you to ask for permissions, the same way you would in a browser, while your app is running on the Teams desktop client.

        Berechtigungen verwalten</span><span class="sxs-lookup"><span data-stu-id="e3cd0-120">Manage permissions</span></span>
  1. Öffnen Sie Teams.Open Teams.
  2. Wählen Sie in der oberen rechten Ecke des Fensters Ihr Profilsymbol aus.In the upper right corner of the window, select your profile icon.
  3. Wählen SettingsSie -> im Dropdownmenü EinstellungenBerechtigungen aus.Select Settings -> Permissions from the drop-down menu.
  4. Wählen Sie die gewünschten Einstellungen aus.Choose your desired settings.

Bildschirm "Geräte Berechtigungen-Desktopeinstellungen"

EigenschaftenProperties

Aktualisieren Sie Ihre APP, manifest.json indem devicePermissions Sie die fünf Eigenschaften hinzufügen und angeben, die Sie in Ihrer Anwendung verwenden möchten:Update your app's manifest.json by adding devicePermissions and specifying which of the five properties you’d like to use in your application:

"devicePermissions": [
    "media",
    "geolocation",
    "notifications",
    "midi",
    "openExternal"
],

Hinweis

Medien werden auch für Kamera Berechtigungen in Mobile verwendet.Media is also used for camera permissions in mobile.

Mit jeder Eigenschaft können Sie den Benutzer auffordern, seine Zustimmung einzuholen.Each property will allow you to prompt the user to ask for their consent

EigenschaftProperty BeschreibungDescription
mediamedia Berechtigung zur Verwendung der Kamera, des Mikrofons und der Lautsprecherpermission to use the camera, microphone and speakers
Geolocationgeolocation Berechtigung zum Zurückgeben des Standorts des Benutzerspermission to return the user's location
Benachrichtigungennotifications Berechtigung zum Senden der Benutzer Benachrichtigungenpermission to send the user notifications
MIDImidi Berechtigung zum Senden und empfangen von MIDI-Informationen von einem digitalen Musikinstrumentpermission to send and receive midi information from a digital musical instrument
openexternopenExternal Berechtigung zum Öffnen von Links in externen Anwendungenpermission to open links in external applications

Überprüfen von Berechtigungen auf der RegisterkarteChecking permissions from your tab

Nachdem Sie Ihrem App-Manifest hinzugefügt haben devicePermissions , können Sie Berechtigungen mit der HTML5-API "Permissions" überprüfen, ohne eine Eingabeaufforderung zu verursachen.Once you’ve added devicePermissions to your app manifest, you can check permissions using the HTML5 “permissions” API without causing a prompt.

// Different query options:
navigator.permissions.query({ name: 'camera' });
navigator.permissions.query({ name: 'microphone' });
navigator.permissions.query({ name: 'geolocation' });
navigator.permissions.query({ name: 'notifications' });
navigator.permissions.query({ name: 'midi', sysex: true });

// Example:
navigator.permissions.query({name:'geolocation'}).then(function(result) {
  if (result.state == 'granted') {
    // Access granted
  } else if (result.state == 'prompt') {
    // Access has not been granted
  }
});

Auffordern des BenutzersPrompting the user

Um eine Eingabeaufforderung anzuzeigen, um die Zustimmung zum Zugriff auf Geräte Berechtigungen zu erhalten, müssen Sie die entsprechende HTML5-oder Teams-API nutzen.In order to show a prompt to get consent to access device permissions you need to leverage the appropriate HTML5 or Teams API. Um den Benutzer zum Zugreifen auf seine Kamera aufzufordern, müssen Sie beispielsweisegetCurrentPositionFor example, in order to prompt the user to access their camera you need to call getCurrentPosition

navigator.geolocation.getCurrentPosition(function (position) { /*... */ });

Um die Kamera auf dem Desktop oder im Internet verwenden zu können, wird von Microsoft Teams eine Berechtigungs Aufforderung angezeigt, wenn Sie getUserMedia aufrufen.To use camera on desktop or web, Teams will show a permission prompt when you call getUserMedia

navigator.mediaDevices.getUserMedia({ audio: true, video: true });

Um Bilder auf mobilen Geräten zu erfassen, fragt Microsoft Teams Mobile um Erlaubnis, wenn Sie captureImage genannt wird ().To capture image on mobile, Teams mobile will ask for permission when called captureImage()

function captureImage(callback: (error: SdkError, files: File[]) => void)

Benachrichtigungen werden vom Benutzer aufgefordert, wenn Sie anrufenrequestPermissionNotifications will prompt the user when you call requestPermission

Notification.requestPermission(function(result) { /* ... */ });

Eingabeaufforderung für Tabs Device Permissions

Berechtigungsverhalten für AnmeldesitzungenPermission behavior across login sessions

Berechtigungen für systemeigene Geräte werden pro Anmeldesitzung gespeichert.Native device permissions are stored per login session. Wenn Sie sich also bei einer anderen Instanz von Teams anmelden (z.b. auf einem anderen Computer), sind Ihre Geräte Berechtigungen aus ihren vorherigen Sitzungen nicht verfügbar.This means that if you log into another instance of Teams (ex: on another computer), your device permissions from your previous sessions will not be available. Stattdessen müssen Sie die Geräte Berechtigungen für die neue Anmeldesitzung erneut genehmigen.Instead, you will need to re-consent to device permissions for the new login session. Dies bedeutet auch, dass Ihre Geräte Berechtigungen für diese vorherige Anmeldesitzung gelöscht werden, wenn Sie sich von Teams abmelden (oder Mandanten innerhalb von Teams wechseln).This also means, if you log out of Teams (or switch tenants inside of Teams), your device permissions will be deleted for that previous login session. Beachten Sie Folgendes, wenn Sie systemeigene Geräte Berechtigungen entwickeln: die systemeigenen Funktionen, die Sie einwilligen, gelten nur für Ihre aktuelle Anmeldesitzung.Please keep this in mind when developing native device permissions: the native capabilities you consent to are only for your current login session.