Feat/ios modern vibration api

[ej-sanmartin]

Fixes #1904

Changes

• Pass seconds duration field from vibrate calls to void vibrate() method in /src/common/ios.mm that was previously being ignored.
• Implemented duration based vibrate() iOS method using iOS 13+ CHHapticEngine.

---

Tested

• Built successfully locally with the following command:

xcodebuild -project platform/xcode/love.xcodeproj \
  -scheme love-ios \
  -configuration Debug \
  -sdk iphonesimulator \
  -destination 'platform=iOS Simulator,name=iPhone 17' \
  clean build

• Vibration can't be tested through unit tests, as reported by source code https://github.com/love2d/love/blob/main/testing/tests/system.lua#L93-L97

[slime73]

Built successfully locally with the following command:

Can it be tested on a physical device too?

[ej-sanmartin]

Thanks for the comment, yes ideally it should be async so it's not blocking the rest of the game's processes. I haven't measured it but most likely there'd be a noticeable performance cost using synchronous implementation that's currently in place.

And I'll test it in my mobile device. With this native API, there's fields that can be adjusted to change how intense and "sharp" the vibration feels. I'll keep them in them as is since further customization would necessitate us to update Love2D's vibrate API for macOS, which would not be so clean potentially if we want to keep this in parity with the Android version.

[ej-sanmartin]

Made the changes and created a minimal Love2D project, which cycles through 3 different vibration calls on iOS.

1st tap tap goes for 1 second, 2nd tap goes for 3 seconds, and the 3rd tap goes for 5 seconds. 4th tap rotates back to the 1 second vibration.

Love2D-vibration-change-on-iOS.MOV

Built successfully with no errors or warnings related to the Haptic Engine initialization (error message did help me identify a missing field though so thanks for suggesting that).

Btw device is an iPhone 14 Pro Max, iOS 26.2