Awesome

ForceTouchGesture

3D Touch Gesture Recognizer written in Swift 2.

This documentation is in Japanese. Please wait for translating it into English.

Introduction

iPhone6S, iPhone6S Plusより3D Touchが導入されました。詳細は以下のAppleの公式ドキュメントをご覧下さい。

• Getting Started with 3D Touch

• 3D Touch APIs

UITouchクラスにforceプロパティが追加され、スクリーンを押したときの圧力を取得できるようになりました。ForceTouchGestureはこのforceプロパティを簡単に取得できるようにしたUIGestureRecognizerのサブクラスを含んでいます。

Requirements

• iOS 7.0+
• Xcode7.1+

Usage

イニシャライズとUIViewへの追加は一般的なUIGestureRecognizerと同じです。

let gestureRecognizer = ForceTouchGestureRecognizer(target: self, action: "forceTouchHandler:")
gestureRecognizer.minimumForce = 4.5
self.touchView.addGestureRecognizer(gestureRecognizer)

Selectorの実装部分ではforceで圧力を取得することができます。 また、forceがminimumForceに設定した値を超えたときに、stateがEndedになります。

func forceTouchHandler(gestureRecognizer: ForceTouchGestureRecognizer) {
	
	let force = gestureRecognizer.force
	// do something
	
	switch gestureRecognizer.state {
		case .Ended:
			// do something
		default:
			break
	}
}

Properties

設定できるプロパティは以下です。

• minimumForce: CGFloat: GestureRecognizerのstateをEndedにする最小のforceの値です。デフォルトは3.0。
• vibrationEnabled: Bool: trueにするとGestureRecognizerのstateがEndedになったときに、システムのバイブレーションが発生します。デモアプリを触ってもらえると分かりますが、3D Touchのデフォルトのバイブレーションではないので、おまけのようなものです。デフォルトはfalse。

取得できるプロパティは以下です。

• force: CGFloat: UITouchクラスのforceの値です。3D Touchに対応していない場合はずっと0のままです。
• forceTouchAvailable: Bool: 3D Touchに対応しているかどうかです。3D Touch対応端末でもiPhoneの設定より3D Touchをオフにすることができるので、現在対応しているかどうかを返します。

License

ForceTouchGesture is released under the MIT license. See LICENSE for details.