진동

  • 아티클

Browse sample. 샘플 찾아보기

이 문서에서는 .NET 다중 플랫폼 앱 UI(.NET MAUI) IVibration 인터페이스를 사용하는 방법을 설명합니다. 이 인터페이스를 사용하면 원하는 시간 동안 진동 기능을 시작하고 중지할 수 있습니다.

인터페이스의 IVibration 기본 구현은 속성을 통해 Vibration.Default 사용할 수 있습니다. IVibration 인터페이스와 Vibration 클래스는 모두 네임스페이스에 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 파일이 자동으로 업데이트됩니다.

디바이스 진동

설정된 시간 또는 기본값인 500밀리초 동안 진동 기능을 요청할 수 있습니다. 다음 코드 예제에서는 다음을 사용하여 1초에서 7초 사이에 디바이스를 임의로 진동합니다 Vibrate(TimeSpan).

private void VibrateStartButton_Clicked(object sender, EventArgs e)
{
    int secondsToVibrate = Random.Shared.Next(1, 7);
    TimeSpan vibrationLength = TimeSpan.FromSeconds(secondsToVibrate);
    
    Vibration.Default.Vibrate(vibrationLength);
}

private void VibrateStopButton_Clicked(object sender, EventArgs e) =>
    Vibration.Default.Cancel();

플랫폼 간 차이점

이 섹션에서는 진동 API와 플랫폼별 차이점에 대해 설명합니다.

플랫폼의 차이점이 없습니다.