Cocos2d-x でジョイスティックをサポートする方法 (Windows/Mac)

2016年11月18日 TOME Leave a comment

こんにちは。

最近 Unity に押されがちですが、根強いファンのいる Cocos2d-x の Windows/Mac ビルドでジョイスティックをサポートする方法をまとめました。特に Windows では落とし穴があるので要注意です。

※ここでいうジョイスティックとは、物理的なジョイスティック（ゲームパッド）のことで、仮想ジョイスティックではありません。
※iOS/Android にはジョイスティックサポートがあるようです。

Contents

1 GLFW の関数を直接呼ぶ
2 以下、Windows版のみの問題
3 GLFW DLL 版のダウンロード
4 ビルドパラメータの変更
- 4.1 関連記事

GLFW の関数を直接呼ぶ

「Cocos2d-x は Windows でも Mac でも動いてすごいわー」と思っていましたが、実装を見てみると内部では GLFW というオープンソースのライブラリーを使用しており、GLFW が Windows/Mac などをサポートしていました。その点で言えば、すごいのは GLFW です。

GLFW の API を見てみると、ジョイスティックサポートもちゃんとあります。ですので、Cocos2d-x に API がないなら GLFW の API を直接呼び出すのがよさそうです。

Cocos2d-x にすでに含まれている glfw3.h をインクルードし、以下の関数を使えば必要最低限の情報は取れます。

glfwJoystickPresent() – ジョイスティックが存在するか調べる
glfwGetJoystickButtons() – ジョイスティックの全ボタン状態を配列で取得
glfwGetJoystickAxes() – ジョイスティックの全スティック状態を配列で取得

例えば以下のような処理を、（scheduleUpdate を行った後）シーンのupdateメソッド内で行えばよいです。

	for (int i = 0; i <= GLFW_JOYSTICK_LAST; i++) {

		if (glfwJoystickPresent(i)) {

			int buttonNum;
			int axisNum;
			const unsigned char* buttons;
			const float* axes;

			buttons = glfwGetJoystickButtons(i, &buttonNum);
			axes = glfwGetJoystickAxes(i, &axisNum);
      
			do_something();
		}
	}

for (int i = 0; i <= GLFW_JOYSTICK_LAST; i++) {

if (glfwJoystickPresent(i)) {

int buttonNum;

int axisNum;

const unsigned char* buttons;

const float* axes;

buttons = glfwGetJoystickButtons(i, &buttonNum);

axes = glfwGetJoystickAxes(i, &axisNum);

do_something();

}

Mac 版ではここまでです。意外と簡単にジョイスティックサポートできましたね！

Windows 版はこのままでは動作しませんので、以下のような対処が必要でした。

以下、Windows版のみの問題

Windowsでは、普通に上記の処理を行っても、glfwJoystickPresent() から 0 が返ってきてしまい、うまくいきません。どうやら、Cocos2d-x 本体 (libcocos2d.dll) がスタティックライブラリ版の GLFW (glfw3.lb) をリンクしていて、それとは別にプログラム本体 (xxxx.exe) もスタティックライブラリ版の GLFW をリンクすることになるので、GLFW の実態が複数存在してしまっているのが原因のようです。

解決方法はいくつかありそうですが、とりあえずDLLバージョンのGLFW使用することで回避できました。