Obiekt Host w Power Apps
Dotyczy: aplikacje kanwy
aplikacje oparte na modelu
Obiekt Host w Power Apps zawiera informacje o bieżącym hoście, na którym działa aplikacja.
Description
Obiekt Host udostępnia informacje na temat urządzenia hostowania, systemu operacyjnego i odtwarzacza uruchamiającego aplikację. Host jest podobny do obiektu Aplikacja i każda aplikacja ma dostęp do tej informacji.
Jednym z najlepszych zastosowań obiektu Host jest debugowanie aplikacji, która nie działa poprawnie na określonym urządzeniu lub w określonej przeglądarce. Właściwości tekstowych tego obiektu można użyć do wyświetlania informacji w interfejsie użytkownika aplikacji za pomocą kontrolki etykiety tekstowej lub rejestrowania informacji w tabeli bazy danych lub w usłudze Application Insights.
Można mieć pokusę używania obiektu Host do dostosowania aplikacji do określonego urządzenia lub przeglądarki. Jednak jest to niebezpieczne, gdyż usługa Power Apps jest przeznaczona do obsługi szerokiej platformy sprzętowej i programowej, a logika oparta na obiekcie Host może nie uwzględniać wszystkich tych platform i z czasem się zmienić. Lepszym rozwiązaniem jest użycie informacji bardziej ograniczonych i niezwiązanych z konkretnym sprzętem i oprogramowaniem. Na przykład można użyć właściwość Rozmiar kontrolki Ekran, aby dostosować ekran do pokazywania mniejszej ilości informacji lub zmieniać organizację informacji podczas pracy na mniejszych urządzeniach, takich jak telefon.
Aby uzyskać dostęp do obiektu Host,w Power Apps Studio, rozwiń obiekt Aplikacja u góry okienka Widok drzewa i wybierz opcję Host. W tym przykładzie obiekt Host nie ma żadnych właściwości akceptujących formuły.
Uwaga
Obiekt hosta jest obecnie dostępny tylko na niestandardowych stronach i w aplikacjach kanwy.
Właściwość BrowserUserAgent
Właściwość tekstu BrowserUserAgent zawiera pełny ciąg agenta użytkownika używany przez przeglądarkę do identyfikowania się podczas uruchamiania aplikacji
Na przykład ciągiem agenta użytkownika przeglądarki może być:
- Mozilla/5.0 (Windows NT 10.0; Win64; x64)
- AppleWebKit/537.36 (KHTML, np. Gecko)
- Chrome/109.0.0.0 Safari/537.36 Edg/109.0.1518.78
Uwaga
Jeśli pracujesz w aplikacji macierzystej Power Apps lub używasz funkcji owijania w Power Apps, aplikacja jest prezentowana za pomocą formantu przeglądarki, co zwinie ciąg agenta użytkownika.
Właściwość OSType
Właściwość OSType zawiera nazwę systemu operacyjnego, w którym działa aplikacja. Typ OSType jest wyznaczany na podstawie ciągu agenta użytkownika wysyłanego przez przeglądarkę do Power Apps. Poniżej przedstawiono przykłady typowych wartości typu OSType:
Wartość |
---|
Okna |
Mac OS |
iOS |
Android |
Linux |
... |
Uwaga
Nie używaj typu OSType do zmiany działania lub funkcji aplikacji w oparciu o zgłoszony system operacyjny.
Tekst OSType może być używany we wszystkich formułach, na przykład w polu właściwości tekstu etykiety:
Label1.Text: "You're running " & Host.OSType
Właściwość SessionID
Właściwość SessionID zwraca identyfikator GUID identyfikujący bieżącą sesję. Dołącz tę informację podczas raportowania problemów administratorowi.
Uwaga
W scenariuszach osadzonych, takich jak Power Apps w usłudze Power BI, właściwość SessionID zwraca bazowy identyfikator sesji Power Apps, a nie identyfikator sesji Power BI.
Label1.Text: $"Provide session ID { Host.SessionID } to your administrator."
Właściwość TenantID
Właściwość TenantID dostarcza unikatowy identyfikator globalny (GUID), który określa dzierżawcę Microsoft Entra skojarzonego z obecnie uwierzytelnionym użytkownikiem.
Uwaga
Podobnie jak w przypadku właściwości SessionID, w scenariuszach osadzonych, takich jak Power Apps w usłudze Power BI, identyfikator dzierżawcy jest dzierżawcą używanym do uwierzytelniania sesji Power Apps.
Label1.Text: Host.TenantID
Właściwość Wersja
Właściwość Wersja umożliwia identyfikację i numer wersji odtwarzacza Power Apps. Podobnie jak w przypadku właściwości browserUserAgent, może zostać zwrócony więcej niż jeden numer wersji, rozdzielony spacjami.
Uwaga
Właściwość Wersja zawsze jest pustym ciągiem podczas pracy w Power Apps Studio.
Label1.Text: Host.Version
Właściwość OfflineEnabled
Właściwość OfflineEnabled umożliwia tryb uruchomieniowy aplikacji w trybie odtwarzaczu Power Apps. W przypadku aplikacji, które nie są włączone w trybie offline, właściwość jest zawsze fałsz. W przypadku aplikacji włączonych w trybie offline właściwość jest fałsz w sieci Web, ale prawda w iOS, Android i Windows.
Uwaga
Nawet jeśli aplikacja kanwy nie działa bez połączeń sieciowych, właściwość OfflineEnabled pozostaje prawda w Power Apps Studio dla aplikacjach kanw, które zostały włączone do używania w trybie offline.
Label1.Text: Host.OfflineEnabled
Przykłady
- Utwórz nową aplikację kanwy.
- Dodaj kontrolkę Etykieta tekstowa i ustaw właściwość
Text
na wartość"Host.BrowserUserAgent: " & Host.BrowserUserAgent
. - Dodaj kontrolkę Etykieta tekstowa i ustaw właściwość
Text
na wartość"Host.OSType: " & Host.OSType
. - Dodaj kontrolkę Etykieta tekstowa i ustaw właściwość
Text
na wartość"Host.SessionID: " & Host.SessionID
. - Dodaj kontrolkę Etykieta tekstowa i ustaw właściwość
Text
na wartość"Host.TenantID: " & Host.TenantID
. - Dodaj kontrolkę Etykieta tekstowa i ustaw właściwość
Text
na wartość"Host.Version: " & Host.Version
. - Dodaj kontrolkę Etykieta tekstowa i ustaw właściwość
Text
na wartość"Host.OfflineEnabled: " & Host.OfflineEnabled
.
Uruchom aplikację na różnych urządzeniach i za pomocą różnych przeglądarek i zobaczysz wyniki podobne do poniższych.
Power Apps Studio w systemie Windows z przeglądarką Edge
Host.Version jest zawsze pustym ciągiem podczas pracy w Power Apps Studio.
Host.BrowserUserAgent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/116.0.0.0 Safari/537.36 Edg/116.0.1938.76
Host.OSType: Windows
Host.SessionID: ee2eed1a-8455-4e68-a433-a709302d0c71
Host.TenantID: 5da56e5c-97b6-468f-a448-a6e432c48269
Host.Version:
Natywny odtwarzacz mobilny Power Apps w systemie iOS
Host.BrowserUserAgent: Mozilla/5.0 (iPhone; CPU iPhone OS 16_6_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148 PowerApps/e1c23ff9-4822-4e75-a003-01c91407a4d2
Host.OSType: Windows
Host.SessionID: 3ebec22f-ee2e-412a-b3eb-45d97db34863
Host.TenantID: 5da56e5c-97b6-468f-a448-a6e432c48269
Host.Version: PowerApps-Native/3.23084.8(iOS)
Odtwarzacz internetowy Power Apps w systemie Windows z przeglądarką Firefox
Host.BrowserUserAgent: Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:109.0) Gecko/20100101 Firefox/117.0
Host.OSType: Windows
Host.SessionID: 283309a4-d88b-4b2a-88de-73b47d1b62d0
Host.TenantID: 5da56e5c-97b6-468f-a448-a6e432c48269
Host.Version: PowerApps-Web/3.23084.6(Windows)
Odtwarzacz internetowy Power Apps w systemie iOS z przeglądarką Safari
Host.BrowserUserAgent: Mozilla/5.0 (iPhone; CPU iPhone OS 16_6_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.6 Mobile/15E148 Safari/604.1
Host.OSType: iOS
Host.SessionID: a09a946d-ce71-4c1f-bd35-519c79849c8d
Host.TenantID: 5da56e5c-97b6-468f-a448-a6e432c48269
Host.Version: PowerApps-Web/3.23084.6(iOS)