촉각 피드백

  • 아티클

Browse sample. 샘플 찾아보기

이 문서에서는 .NET 다중 플랫폼 앱 UI(.NET MAUI) IHapticFeedback 인터페이스를 사용하여 디바이스에서 촉각 피드백을 제어하는 방법을 설명합니다. 촉각 피드백은 일반적으로 사용자에게 응답을 제공하기 위해 디바이스에서 제공하는 부드러운 진동 감각에 의해 나타납니다. 촉각 피드백의 몇 가지 예는 사용자가 가상 키보드를 사용하거나 플레이어의 캐릭터가 적 캐릭터와 만나는 게임을 할 때입니다.

인터페이스의 IHapticFeedback 기본 구현은 속성을 통해 HapticFeedback.Default 사용할 수 있습니다. IHapticFeedback 인터페이스와 HapticFeedback 클래스는 모두 네임스페이스에 Microsoft.Maui.Devices 포함됩니다.

시작하기

촉각 피드백 기능에 액세스하려면 다음 플랫폼별 설정이 필요합니다.

Vibrate 권한이 필요하며 Android 프로젝트에서 구성해야 합니다. 이 권한은 다음과 같은 방법으로 추가할 수 있습니다.

  • 어셈블리 기반 권한을 추가합니다.

    Platforms/Android/MainApplication.cs 파일을 열고 지시문 다음에 using 다음 어셈블리 특성을 추가합니다.

    [assembly: UsesPermission(Android.Manifest.Permission.Vibrate)]

    - 또는 -

  • Android 매니페스트를 업데이트합니다.

    Platforms/Android/AndroidManifest.xml 파일을 열고 노드에 다음을 manifest 추가합니다.

    <uses-permission android:name="android.permission.VIBRATE" />

    - 또는 -

  • 매니페스트 편집기에서 Android 매니페스트를 업데이트합니다.

    Visual Studio에서 Platforms/Android/AndroidManifest.xml 파일을 두 번 클릭하여 Android 매니페스트 편집기를 엽니다. 그런 다음 필수 권한에서 VIBRATE 권한을 검사. 그러면 AndroidManifest.xml 파일이 자동으로 업데이트됩니다.

촉각 피드백 사용

촉각 피드백 기능은 짧은 Click 모드 또는 LongPress1의 두 가지 모드로 수행됩니다. 다음 코드 예제에서는 클릭한 사용자에 대한 Button 촉각 피드백 응답을 시작 ClickLongPress 합니다.

private void HapticShortButton_Clicked(object sender, EventArgs e) =>
    HapticFeedback.Default.Perform(HapticFeedbackType.Click);

private void HapticLongButton_Clicked(object sender, EventArgs e) =>
    HapticFeedback.Default.Perform(HapticFeedbackType.LongPress);