be able to specify maximum count of multi-tap #419

dera- · 2022-12-02T07:55:19Z

このpull requestが解決する内容

game.json の "maxPoints" で最大同時タップ数を制限できるように

破壊的な変更を含んでいるか?

なし

dera- · 2022-12-02T07:56:30Z

package.json

@@ -4,7 +4,7 @@
  "description": "The core library of Akashic Engine",
  "main": "index.js",
  "dependencies": {
-    "@akashic/game-configuration": "~1.6.0",
+    "@akashic/game-configuration": "file:../game-configuration/akashic-game-configuration-1.6.0.tgz",


こちらローカルで動作確認するために一時的にこのような依存にしています。
akashic-games/game-configuration#33 がマージされましたら修正します

dera- · 2022-12-02T07:59:59Z

src/PointEventResolver.ts

@@ -48,16 +53,23 @@ export interface PointEventResolverParameterObject {
 export class PointEventResolver {
 	_sourceResolver: PointSourceResolver;
 	_playerId: string;
+	_maxPoints: number | null;
+	private _currentPoints: number = 0;


_pointEventMapのキー数を数えることも考えましたが、point~()メソッドは頻繁に呼ばれるのでそこで何度もObject.keysを呼び出すのは処理の無駄かと思いましたので、この変数を用意しました

dera- · 2022-12-02T08:00:32Z

src/PointEventResolver.ts

-	pointDown(e: PlatformPointEvent): pl.PointDownEvent {
+	pointDown(e: PlatformPointEvent): pl.PointDownEvent | null {
+		if (this._maxPoints != null && this._currentPoints >= this._maxPoints) {
+			return null;


他のメソッドに合わせて、タップの上限数を超えた時はnullを返すようにしてます

xnv · 2022-12-05T10:06:55Z

src/PointEventResolver.ts

@@ -84,6 +96,7 @@ export class PointEventResolver {
 			point.y, //                5: Y座標
 			targetId //                6?: エンティティID
 		];
+		this._currentPoints++;


これ前後の行で ret を組み立てている途中に割り込む形になっているので動かしたいです。 _pointEventMap の状態と整合的でなければならない値なので、 _pointEventMap への代入の直後にやりませんか。

了解しました、そのように修正します。
同時にpointUp()でのthis._currentPoints--も_pointEventMapからオブジェクトを削除した直後に行おうと思います。

xnv · 2022-12-05T10:15:30Z

src/__tests__/PointEventResolverSpec.ts

+		expect(e!.length).toBe(7);
+		expect(e![0]).toBe(pl.EventCode.PointDown); // 0: イベントコード
+		expect(e![1]).toBe(EventPriority.Joined); //   1: 優先度
+		expect(e![2]).toBe("dummyPlayerId"); //        2: プレイヤーID
+		expect(e![3]).toBe(0); //                      3: ポインターID
+		expect(e![4]).toBe(10); //                     4: X座標
+		expect(e![5]).toBe(20); //                     5: Y座標
+		expect(e![6]).toBeUndefined(); //              6?: エンティティID


(ラッパー関数を定義しなくちゃいけないあたり) 一長一短ですが、こういう手もあるようです: DefinitelyTyped/DefinitelyTyped#41179 (comment)

ありがとうございます。expect_toBeDefined()に相当する関数をhelperディレクトリ以下に定義して利用してみようと思います

xnv · 2022-12-05T10:17:11Z

src/PointEventResolver.ts

@@ -31,6 +31,11 @@ export interface PointEventResolverParameterObject {
 	 * プレイヤーID
 	 */
 	playerId: string;
+
+	/**
+	 * 同時にタップ可能な上限


タップ可能 → ポイント可能としたいです。(この文脈ではタップとクリックをまとめてポイントと呼んでいるので)

了解しました、こちら修正します

xnv · 2022-12-05T10:44:40Z

src/__tests__/PointEventResolverSpec.ts

@@ -208,4 +211,37 @@ describe("PointEventResolver", () => {
 			})
 		).toBeNull();
 	});
+
+	it("can not multi-tap more than maxPoints", () => {


余談: multi-tap は英語としてポピュラーな表現ではなさそうです。 multi touch がよいかもしれません。

https://ja.wikipedia.org/wiki/%E3%83%9E%E3%83%AB%E3%83%81%E3%82%BF%E3%83%83%E3%83%97

https://en.wikipedia.org/wiki/Multi-tap

一箇所だけ Android のページで https://developer.android.com/training/gestures/multi?hl=ja マルチタップと表記がありますが、英語版ページだと multi-touch になっています。

なるほど、、英語での表現だとmulti-touchの方がよく使われる感じなんですね。ありがとうございます、そのように修正しておきます

xnv

コメント加えていますが approved.

xnv · 2022-12-07T04:52:01Z

src/__tests__/helpers/expectToBeDefined.ts

@@ -0,0 +1,4 @@
+export function expectToBeDefined<T>(arg: T): asserts arg is NonNullable<T> {
+	expect(arg).toBeDefined();
+	// if (arg == null)  throw new Error("arg is null");


不要なコメントなら削除したいです。

了解しました、こちら削除します

xnv · 2022-12-07T04:52:47Z

src/__tests__/ESpec.ts

@@ -11,8 +11,8 @@ import {
 	PointUpEvent,
 	PointMoveEvent
 } from "..";
-import type { Runtime } from "./helpers";
-import { customMatchers, EntityStateFlags, Game, Renderer, skeletonRuntime } from "./helpers";
+import type { Runtime} from "./helpers";


空白が変に消えてしまっているようです。

あ、、こちらも修正します

be able to specify maximum count of multi-tap

c188595

dera- requested review from xnv and ShinobuTakahashi December 2, 2022 07:55

dera- commented Dec 2, 2022

View reviewed changes

xnv reviewed Dec 5, 2022

View reviewed changes

reflect pr comment

b734e73

xnv approved these changes Dec 7, 2022

View reviewed changes

ShinobuTakahashi approved these changes Dec 7, 2022

View reviewed changes

dera- added 5 commits December 7, 2022 22:40

reflect pr comment

7a48790

resolve conflict

bdd228d

resolve conflict when merged

17f3bb6

update package-lock.json

3b9fa42

v3.9.3

2ae5ef6

dera- merged commit d44b1fc into main Jan 25, 2023

dera- deleted the add-max-points branch January 25, 2023 11:19

be able to specify maximum count of multi-tap #419

be able to specify maximum count of multi-tap #419

Uh oh!

Conversation

dera- commented Dec 2, 2022

このpull requestが解決する内容

破壊的な変更を含んでいるか?

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

xnv left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!