【Unity开发】控制手机移动端的震动
目录
- 一、前言
- 二、Unity的Handheld.Vibrate()
- 三、调用Android原生代码
- 四、NiceVibrations插件
- 五、DeviceVibration插件
- 六、控制游戏手柄震动
- 七、结语
一、前言
最近开发了一个新的功能——特定情况下让手机震动，例如点击界面中的按钮，手机震动一下。这也是第一次写移动端的震动的功能，虽然unity有自带的控制移动设备震动的API，但是API太过于单一不太符合功能要求，因为他只有最简单的0.5秒的震动，不能控制震动的时长和强度。然而对于一个按钮的震动反馈来讲，0.5秒的时长有点长了。
上网查阅了大量的相关的资料，最终还不错的解决的功能的开发，所以在这里就罗列出我找到的所有能控制手机震动的API插件。
最后还有控制游戏手柄震动的API
二、Unity的Handheld.Vibrate()
这是Unity自带的API，这个方法可以触发移动设备的震动。我们直接看下使用的示例
// 判断当前设备是否支持震动（最好检查一下，万一手机不支持或者马达坏了有可能报错）
if (SystemInfo.supportsVibration)
{Handheld.Vibrate();
}
else
{Debug.Log("设备不支持震动");
}
哦对了，一般是Unity自带的API的话，也是同时支持IOS系统的，但是下面说的这个就只支持安卓系统。
三、调用Android原生代码
这个方法是直接通过调用Android的Java API来控制震动时长的，所以为什么说只支持安卓系统不支持IOS系统，就是因为直接用的Android的Java API。直接来看下下如何使用吧。
方法还是比较简单的，先创建一个用于调用Android原生代码的C#脚本：
using UnityEngine;
public class VibrationManager : MonoBehaviour
{public static void Vibrate(long milliseconds){if (Application.platform == RuntimePlatform.Android){try{using (AndroidJavaClass unityPlayer = new AndroidJavaClass("com.unity3d.player.UnityPlayer")){using (AndroidJavaObject currentActivity = unityPlayer.GetStatic<AndroidJavaObject>("currentActivity")){using (AndroidJavaObject vibrator = currentActivity.Call<AndroidJavaObject>("getSystemService", "vibrator")){if (vibrator != null){vibrator.Call("vibrate", milliseconds);}}}}}catch (System.Exception e){Debug.LogError("VibrationManager: Error while trying to vibrate - " e.Message);}}}
}
然后就可以在需要震动的地方调用这个方法：
VibrationManager.Vibrate(1000); // 震动1000毫秒
当然你也可以直接把 Vibrate() 方法写在要使用的脚本文件中，就不用单独写一个脚本弄一个静态函数了。使用的时候就直接 Vibrate(1000) 就可以，简介明了！
四、NiceVibrations插件
我在项目中使用的插件就是这个，这个插件灵活性很高，且简单易操作，而且支持Android和IOS。
直接来说一下插件导入之后如何使用
首先要引入命名空间
using MoreMountains.NiceVibrations
然后就是在需要的地方调用代码了。
// 普通的振动
MMVibrationManager.Vibrate();// 不同模式的振动
MMVibrationManager.Haptic(HapticTypes.Selection);1.HapticTypes.Selection：极轻微振动——可用于点击按钮2.HapticTypes.Success：普通振动——可用于游戏胜利3.HapticTypes.Warning：普通振动——可用于游戏提示4.HapticTypes.Failure：普通振动——可用于游戏失败5.HapticTypes.LightImpact：轻微振动6.HapticTypes.MediumImpact：中度振动7.HapticTypes.HeavyImpact：重度振动8.HapticTypes.RigidImpact：强硬而时间稍长一些的振动9.HapticTypes.SoftImpact：柔软而时间稍长一些的振动// 瞬间振动，震动时长大致只有0.1s左右
MMVibrationManager.TransientHaptic(float intensity, float sharpness);参数：float intensity 强度0-1float sharpness 感知度0-1//还有几个默认的参数，bool alsoRumble = falseMonoBehaviour coroutineSupport = nullint controllerID = -1//连续的振动
MMVibrationManager.ContinuousHaptic(float intensity, float sharpness, float duration, HapticTypes fallbackOldiOS, this);
参数：float intensity 强度0-1float sharpness 感知度0-1float duration 持续时间HapticTypes fallbackOldiOS = HapticTypes.None 振动类型//控制全局的Haptic振动开启或关闭
MMVibrationManager.SetHapticsActive(true);
MMVibrationManager.SetHapticsActive(false);//获取设备是否支持Haptic振动
bool isSupported = MMVibrationManager.HapticsSupported();
除了上面的一下触发震动的操作，还有一下事件的回调可以绑定，但是仅限于 MMVibrationManager.Haptic 的震动
//OnEnable进行绑定
private void OnEnable()
{MMNViOSCoreHaptics.OnHapticPatternStopped += OnHapticsStopped;MMNViOSCoreHaptics.OnHapticPatternError += OnHapticsError;MMNViOSCoreHaptics.OnHapticPatternReset += OnHapticsReset;
}//OnDisable时解除绑定
private void OnDisable()
{MMNViOSCoreHaptics.OnHapticPatternStopped -= OnHapticsStopped;MMNViOSCoreHaptics.OnHapticPatternError -= OnHapticsError;MMNViOSCoreHaptics.OnHapticPatternReset -= OnHapticsReset;
}//振动结束
protected virtual void OnHapticsStopped()
{//一些处理逻辑
}//振动错误
protected virtual void OnHapticsError()
{//一些处理逻辑
}//振动重置
protected virtual void OnHapticsReset()
{//一些处理逻辑
}
MMVibrationManager.TransientHaptic 和 MMVibrationManager.ContinuousHaptic 的事件也有，但是比较少，只有结束事件
private void OnEnable()
{MMNViOSCoreHaptics.OnHapticPatternStopped += OnHapticsStopped;
}private void OnDisable()
{MMNViOSCoreHaptics.OnHapticPatternStopped -= OnHapticsStopped;
}//振动结束
protected virtual void OnHapticsStopped()
{}
五、DeviceVibration插件
插件的灵活度还可以，对于日常简单的开发就够用了，但是导入的时候需要自己处理一下意外情况（比如报错）。
插件里面也自带使用的示例，有一个Scene示例场景，可以打包成移动端自己测试一下，下面就是它的示例代码，看起来还是比较简介的。
using System.Collections;
using System.Collections.Generic;
using UnityEngine;
using System.IO;namespace BrainCheck {public enum VibrationIntensity {vibrationIntensity_1,vibrationIntensity_2,vibrationIntensity_3,vibrationIntensity_4,vibrationIntensity_5,vibrationIntensity_6,vibrationWithDelay}public class DemoScript : MonoBehaviour{public VibrationIntensity myOption;void OnMouseUp() {StartCoroutine(BtnAnimation());}private IEnumerator BtnAnimation(){Vector3 originalScale = gameObject.transform.localScale;gameObject.transform.localScale = 0.9f * gameObject.transform.localScale;yield return new WaitForSeconds(0.2f);gameObject.transform.localScale = originalScale;ButtonAction();}private void ButtonAction() {switch(myOption) {case VibrationIntensity.vibrationIntensity_1:BrainCheck.VibrationIntensityBridge.vibrationIntensity_1();break;case VibrationIntensity.vibrationIntensity_2:BrainCheck.VibrationIntensityBridge.vibrationIntensity_2();break;case VibrationIntensity.vibrationIntensity_3:BrainCheck.VibrationIntensityBridge.vibrationIntensity_3();break;case VibrationIntensity.vibrationIntensity_4:BrainCheck.VibrationIntensityBridge.vibrationIntensity_4();break;case VibrationIntensity.vibrationIntensity_5:BrainCheck.VibrationIntensityBridge.vibrationIntensity_5();break;case VibrationIntensity.vibrationIntensity_6:BrainCheck.VibrationIntensityBridge.vibrationIntensity_6();break;case VibrationIntensity.vibrationWithDelay:#if UNITY_IOSBrainCheck.VibrationIntensityBridge.vibrationWithDelay(4, 6);#endif#if UNITY_ANDROIDBrainCheck.VibrationIntensityBridge.vibrationWithDelay(6000, 400);#endifbreak;}}}
}六、控制游戏手柄震动
这个相对来说比较简单，没必要另外单独一篇文章进行讲述了，索性直接放在了一起说。
unity中的 Input.SetVibration 方法可以设置手柄的左右震动马达强度。震动强度是一个0到1之间的浮点数，其中0表示无震动，1表示最大震动强度。
直接看下示例：（以Xbox手柄为例）
using UnityEngine;
public class GamepadVibrationExample : MonoBehaviour
{void Update(){// 检测手柄按钮输入，例如按下"A"键时震动if (Input.GetKeyDown(KeyCode.JoystickButton0)) // Xbox手柄的"A"键通常对应JoystickButton0{// 设置手柄震动，左马达和右马达的震动强度分别为0.5和1.0Input.SetVibration(0, 0.5f, 1.0f);}// 检测手柄按钮输入，例如按下"B"键时停止震动if (Input.GetKeyDown(KeyCode.JoystickButton1)) // Xbox手柄的"B"键通常对应JoystickButton1{// 停止手柄震动Input.SetVibration(0, 0.0f, 0.0f);}}
}
七、结语
插件就这么多，仅供交流学习，有什么问题也欢迎再评论区留言或者私信，我看到的话会及时回复，下期见，拜拜。
