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 App i każda aplikacja ma dostęp do tych 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

1. Utwórz nową aplikację kanwy.
2. Dodaj kontrolkę Etykieta tekstowa i ustaw właściwość Text na wartość "Host.BrowserUserAgent: " & Host.BrowserUserAgent.
3. Dodaj kontrolkę Etykieta tekstowa i ustaw właściwość Text na wartość "Host.OSType: " & Host.OSType.
4. Dodaj kontrolkę Etykieta tekstowa i ustaw właściwość Text na wartość "Host.SessionID: " & Host.SessionID.
5. Dodaj kontrolkę Etykieta tekstowa i ustaw właściwość Text na wartość "Host.TenantID: " & Host.TenantID.
6. Dodaj kontrolkę Etykieta tekstowa i ustaw właściwość Text na wartość "Host.Version: " & Host.Version.
7. 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

Parametr Host.Version jest zawsze pusty podczas pracy 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: aaaabbbb-0000-cccc-1111-dddd2222eeee
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: aaaabbbb-0000-cccc-1111-dddd2222eeee
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: aaaabbbb-0000-cccc-1111-dddd2222eeee
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: aaaabbbb-0000-cccc-1111-dddd2222eeee
Host.Version: PowerApps-Web/3.23084.6(iOS)