Dane wejściowe i interakcje

Aplikacje WinUI automatycznie obsługują szeroką gamę danych wejściowych i działają na różnych urządzeniach — na przykład nie trzeba wykonywać żadnych dodatkowych czynności w celu włączenia wprowadzania danych dotykowych. Czasami jednak możesz chcieć zoptymalizować aplikację pod kątem niektórych typów danych wejściowych lub urządzeń. Jeśli na przykład tworzysz aplikację do rysowania, możesz dostosować sposób obsługi wprowadzania danych za pomocą pióra.

Instrukcje dotyczące projektowania i kodowania w tej sekcji ułatwiają dostosowanie aplikacji WinUI pod kątem określonych typów danych wejściowych.

Używanie interfejsów API wejściowych środowisko wykonawcze systemu Windows w aplikacjach klasycznych WinUI 3

Aplikacje komputerowe WinUI 3 mogą bezpośrednio korzystać z większości interfejsów API środowiska środowisko wykonawcze systemu Windows (WinRT), w tym z wielu interfejsów API związanych z obsługą danych wejściowych z przestrzeni nazw Windows.Devices.Input, Windows.Gaming.Input i Windows.UI.Input. Nie musisz tworzyć aplikacji UWP, aby uzyskać dostęp do tych możliwości.

Należy pamiętać o kilku zagadnieniach:

  • Działa w dowolnej aplikacji WinUI 3 — właściwości wskaźnika (nacisk, nachylenie, przycisk boczny), wykrywanie urządzeń, dostęp do sprzętu kontrolera (Windows.Gaming.Input) oraz obsługa dotyku i myszy działają bez żadnej specjalnej konfiguracji.
  • Wymaga tożsamości pakietu (MSIX) — niektóre interfejsy API, takie jak SpeechRecognizer i SpeechSynthesizer, wymagają, aby aplikacja miała tożsamość pakietu. Domyślny szablon projektu WinUI 3 używa pakietu MSIX, więc to wymaganie jest spełnione automatycznie dla większości aplikacji.
  • Tylko dla UWP — interfejsy API zależne od ApplicationView, CoreWindow lub wzorca GetForCurrentView nie są dostępne w aplikacjach klasycznych. Obejmuje to śledzenie spojrzeń (GazeInputSourcePreview) i iniekcję danych wejściowych (InputInjector). W przypadku tych funkcji dokumentacja referencyjna platformy UWP pozostaje najlepszym zasobem.

Aby uzyskać pełną listę obsługiwanych i nieobsługiwanych interfejsów API WinRT w aplikacjach klasycznych, zobacz Interfejsy API środowiska środowisko wykonawcze systemu Windows obsługiwane w aplikacjach klasycznych.

Tip

Tematy w tej sekcji, które zawierają link do dokumentacji platformy UWP, obejmują funkcje korzystające z interfejsów API tylko platformy UWP. Nadal możesz odwoływać się do tych tematów jako do źródła wskazówek i koncepcji projektowych, mimo że interfejsy API nie są bezpośrednio dostępne w aplikacjach klasycznych WinUI 3.

Wprowadzenie

Temat Opis
Podstawy przygotowania danych wejściowych Zapoznaj się z każdym typem urządzenia wejściowego, jego zachowaniami, możliwościami i ograniczeniami, gdy jest używane z określonymi kształtami i rozmiarami.
Wejście wzrokowe Śledź spojrzenie użytkownika na podstawie lokalizacji i ruchu oczu i głowy. Interfejsy API śledzenia wzroku wymagają platformy UWP; zobacz podlinkowaną dokumentację referencyjną UWP.

Urządzenia wejściowe

Temat Opis
Identyfikowanie urządzeń wejściowych Zidentyfikuj urządzenia wejściowe podłączone do urządzenia aplikacji systemu Windows i zidentyfikuj ich możliwości i atrybuty.
Wskaźnik Odbieranie, przetwarzanie i zarządzanie danymi wejściowymi z urządzeń wskazujących, takich jak dotyk, mysz, pióro/rysik i touchpad.
Pióro i atrament systemu Windows Obsługuj właściwości wejścia specyficzne dla pióra, takie jak nacisk, pochylenie, przycisk boczny i wykrywanie gumki.
Touch Obsługuj wprowadzanie dotykowe, aby tworzyć immersyjne doświadczenia, które użytkownicy mogą odkrywać z pewnością.
Mysz Obsługa wprowadzania myszy w aplikacji, w tym kliknięć przycisków, kółka przewijania i ruchu wskaźnika.
Klawiatura Obsługuj dane wejściowe z klawiatury, istotny element interakcji z użytkownikiem i niezbędny warunek dostępności.
Gamepad i zdalne sterowanie Projektowanie z myślą o obsłudze za pomocą kontrolera Xbox i pilota. Interfejsy API Windows.Gaming.Input działają bezpośrednio w aplikacjach klasycznych WinUI 3; w podlinkowanym temacie dotyczącym platformy UWP omówiono wzorce projektowe dla interfejsu 10-foot.
Touchpad Obsługa wejścia z panelu dotykowego, które łączy pośrednie wielodotykowe wprowadzanie danych z precyzją urządzenia wskazującego.
Wiele danych wejściowych Zaprojektuj aplikację, aby pracować z jak największą liczbą typów danych wejściowych, aby zmaksymalizować elastyczność, użyteczność i dostępność.
Niestandardowe wprowadzanie tekstu Podstawowe interfejsy API tekstu umożliwiają odbieranie danych wejściowych tekstu z dowolnej usługi tekstowej obsługiwanej na urządzeniach Windows w dowolnym języku i z dowolnego typu danych wejściowych.

Interakcje

Temat Opis
przeciąganie i upuszczanie Włącz interakcje przeciągania i upuszczania w aplikacji.
Panoramowanie Wskazówki dotyczące wdrażania interakcji panoramowania.
Rotacja Wskazówki dotyczące implementowania interakcji rotacji.
Wybieranie tekstu i obrazów Wskazówki dotyczące wybierania tekstu, obrazów i kontrolek oraz manipulowania nimi.
Targetowanie Wytyczne dotyczące obszarów dotykowych i wizualnej informacji zwrotnej.
Opinie wizualne Przekaż użytkownikom wizualną opinię podczas interakcji.
Powiększenie optyczne i zmiana rozmiaru Wskazówki dotyczące powiększania i zmieniania rozmiaru elementów.

Mowa i opinie

Temat Opis
Przemówienie Integrowanie rozpoznawania mowy i zamiany tekstu na mowę bezpośrednio w środowisko użytkownika aplikacji. Wymaga identyfikatora pakietu.
Haptyki Dodaj informacje zwrotne przy dotyku, aby wzmocnić reakcję na działania użytkownika i zapewnić bardziej responsywne, intuicyjne interakcje.
  • Last updated on