回應觸控事件
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
讓物件根據旋轉三角形等預設程式移動物件,有助於
吸引註意,但如果想讓使用者與您的 OpenGL ES 圖形互動,該怎麼做?
讓 OpenGL ES 應用程式具有互動性的關鍵是擴大實作
GLSurfaceView
可覆寫
onTouchEvent()
會監聽觸控事件。
本課程將說明如何監聽觸控事件,讓使用者旋轉 OpenGL ES 物件。
設定觸控事件監聽器
如要讓 OpenGL ES 應用程式回應觸控事件,您必須實作
onTouchEvent()
方法中的
GLSurfaceView
類別。以下實作範例說明如何監聽
MotionEvent.ACTION_MOVE
事件並轉譯為
形狀的旋轉角度。
Kotlin
private const val TOUCH_SCALE_FACTOR: Float = 180.0f / 320f
...
private var previousX: Float = 0f
private var previousY: Float = 0f
override fun onTouchEvent(e: MotionEvent): Boolean {
// MotionEvent reports input details from the touch screen
// and other input controls. In this case, you are only
// interested in events where the touch position changed.
val x: Float = e.x
val y: Float = e.y
when (e.action) {
MotionEvent.ACTION_MOVE -> {
var dx: Float = x - previousX
var dy: Float = y - previousY
// reverse direction of rotation above the mid-line
if (y > height / 2) {
dx *= -1
}
// reverse direction of rotation to left of the mid-line
if (x < width / 2) {
dy *= -1
}
renderer.angle += (dx + dy) * TOUCH_SCALE_FACTOR
requestRender()
}
}
previousX = x
previousY = y
return true
}
Java
private final float TOUCH_SCALE_FACTOR = 180.0f / 320;
private float previousX;
private float previousY;
@Override
public boolean onTouchEvent(MotionEvent e) {
// MotionEvent reports input details from the touch screen
// and other input controls. In this case, you are only
// interested in events where the touch position changed.
float x = e.getX();
float y = e.getY();
switch (e.getAction()) {
case MotionEvent.ACTION_MOVE:
float dx = x - previousX;
float dy = y - previousY;
// reverse direction of rotation above the mid-line
if (y > getHeight() / 2) {
dx = dx * -1 ;
}
// reverse direction of rotation to left of the mid-line
if (x < getWidth() / 2) {
dy = dy * -1 ;
}
renderer.setAngle(
renderer.getAngle() +
((dx + dy) * TOUCH_SCALE_FACTOR));
requestRender();
}
previousX = x;
previousY = y;
return true;
}
請注意,計算旋轉角度之後,這個方法會呼叫
requestRender()
用來通知
轉譯器轉譯影格。這種方法本例中最有效
因為除非旋轉角度發生變更,否則不需要重新繪製頁框。不過
「不會」影響效率,除非您同時要求轉譯器只在
使用 setRenderMode()
處理資料變更
方法,因此請確保這一行在轉譯器中未加註:
Kotlin
class MyGlSurfaceView(context: Context) : GLSurfaceView(context) {
init {
// Render the view only when there is a change in the drawing data
renderMode = GLSurfaceView.RENDERMODE_WHEN_DIRTY
}
}
Java
public MyGLSurfaceView(Context context) {
...
// Render the view only when there is a change in the drawing data
setRenderMode(GLSurfaceView.RENDERMODE_WHEN_DIRTY);
}
公開旋轉角度
上述程式碼範例要求您必須透過轉譯器公開旋轉角度,
並新增公開成員轉譯器程式碼在主使用者以外的另一個執行緒上執行
應用程式的介面執行緒,您必須將此公開變數宣告為 volatile
。
下列程式碼可宣告變數,並公開 getter 和 setter 組合:
Kotlin
class MyGLRenderer4 : GLSurfaceView.Renderer {
@Volatile
var angle: Float = 0f
}
Java
public class MyGLRenderer implements GLSurfaceView.Renderer {
...
public volatile float mAngle;
public float getAngle() {
return mAngle;
}
public void setAngle(float angle) {
mAngle = angle;
}
}
套用旋轉效果
如要套用觸控輸入產生的旋轉效果,請將產生角度和
新增一個變數,其中包含觸控輸入產生的角度:
Kotlin
override fun onDrawFrame(gl: GL10) {
...
val scratch = FloatArray(16)
// Create a rotation for the triangle
// long time = SystemClock.uptimeMillis() % 4000L;
// float angle = 0.090f * ((int) time);
Matrix.setRotateM(rotationMatrix, 0, angle, 0f, 0f, -1.0f)
// Combine the rotation matrix with the projection and camera view
// Note that the mvpMatrix factor *must be first* in order
// for the matrix multiplication product to be correct.
Matrix.multiplyMM(scratch, 0, mvpMatrix, 0, rotationMatrix, 0)
// Draw triangle
triangle.draw(scratch)
}
Java
public void onDrawFrame(GL10 gl) {
...
float[] scratch = new float[16];
// Create a rotation for the triangle
// long time = SystemClock.uptimeMillis() % 4000L;
// float angle = 0.090f * ((int) time);
Matrix.setRotateM(rotationMatrix, 0, mAngle, 0, 0, -1.0f);
// Combine the rotation matrix with the projection and camera view
// Note that the vPMatrix factor *must be first* in order
// for the matrix multiplication product to be correct.
Matrix.multiplyMM(scratch, 0, vPMatrix, 0, rotationMatrix, 0);
// Draw triangle
mTriangle.draw(scratch);
}
完成上述步驟後,請執行程式,然後用手指拖曳
旋轉三角形:
圖 1. 以觸控輸入方式旋轉的三角形 (圓圈顯示觸控處)
或 HTTP/HTTPS 位置)
這個頁面中的內容和程式碼範例均受《內容授權》中的授權所規範。Java 與 OpenJDK 是 Oracle 和/或其關係企業的商標或註冊商標。
上次更新時間:2025-07-27 (世界標準時間)。
[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["缺少我需要的資訊","missingTheInformationINeed","thumb-down"],["過於複雜/步驟過多","tooComplicatedTooManySteps","thumb-down"],["過時","outOfDate","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["示例/程式碼問題","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間:2025-07-27 (世界標準時間)。"],[],[],null,["# Respond to touch events\n\nMaking objects move according to a preset program like the rotating triangle is useful for\ngetting some attention, but what if you want to have users interact with your OpenGL ES graphics?\nThe key to making your OpenGL ES application touch interactive is expanding your implementation of\n[GLSurfaceView](/reference/android/opengl/GLSurfaceView) to override the\n[onTouchEvent()](/reference/android/view/View#onTouchEvent(android.view.MotionEvent)) to listen for touch events.\n\nThis lesson shows you how to listen for touch events to let users rotate an OpenGL ES object.\n\nSetup a touch listener\n----------------------\n\nIn order to make your OpenGL ES application respond to touch events, you must implement the\n[onTouchEvent()](/reference/android/view/View#onTouchEvent(android.view.MotionEvent)) method in your\n[GLSurfaceView](/reference/android/opengl/GLSurfaceView) class. The example implementation below shows how to listen for\n[MotionEvent.ACTION_MOVE](/reference/android/view/MotionEvent#ACTION_MOVE) events and translate them to\nan angle of rotation for a shape. \n\n### Kotlin\n\n```kotlin\nprivate const val TOUCH_SCALE_FACTOR: Float = 180.0f / 320f\n...\nprivate var previousX: Float = 0f\nprivate var previousY: Float = 0f\n\noverride fun onTouchEvent(e: MotionEvent): Boolean {\n // MotionEvent reports input details from the touch screen\n // and other input controls. In this case, you are only\n // interested in events where the touch position changed.\n\n val x: Float = e.x\n val y: Float = e.y\n\n when (e.action) {\n MotionEvent.ACTION_MOVE -\u003e {\n\n var dx: Float = x - previousX\n var dy: Float = y - previousY\n\n // reverse direction of rotation above the mid-line\n if (y \u003e height / 2) {\n dx *= -1\n }\n\n // reverse direction of rotation to left of the mid-line\n if (x \u003c width / 2) {\n dy *= -1\n }\n\n renderer.angle += (dx + dy) * TOUCH_SCALE_FACTOR\n requestRender()\n }\n }\n\n previousX = x\n previousY = y\n return true\n}\n```\n\n### Java\n\n```java\nprivate final float TOUCH_SCALE_FACTOR = 180.0f / 320;\nprivate float previousX;\nprivate float previousY;\n\n@Override\npublic boolean onTouchEvent(MotionEvent e) {\n // MotionEvent reports input details from the touch screen\n // and other input controls. In this case, you are only\n // interested in events where the touch position changed.\n\n float x = e.getX();\n float y = e.getY();\n\n switch (e.getAction()) {\n case MotionEvent.ACTION_MOVE:\n\n float dx = x - previousX;\n float dy = y - previousY;\n\n // reverse direction of rotation above the mid-line\n if (y \u003e getHeight() / 2) {\n dx = dx * -1 ;\n }\n\n // reverse direction of rotation to left of the mid-line\n if (x \u003c getWidth() / 2) {\n dy = dy * -1 ;\n }\n\n renderer.setAngle(\n renderer.getAngle() +\n ((dx + dy) * TOUCH_SCALE_FACTOR));\n requestRender();\n }\n\n previousX = x;\n previousY = y;\n return true;\n}\n```\n\nNotice that after calculating the rotation angle, this method calls\n[requestRender()](/reference/android/opengl/GLSurfaceView#requestRender()) to tell the\nrenderer that it is time to render the frame. This approach is the most efficient in this example\nbecause the frame does not need to be redrawn unless there is a change in the rotation. However, it\ndoes not have any impact on efficiency unless you also request that the renderer only redraw when\nthe data changes using the [setRenderMode()](/reference/android/opengl/GLSurfaceView#setRenderMode(int))\nmethod, so make sure this line is uncommented in the renderer: \n\n### Kotlin\n\n```kotlin\nclass MyGlSurfaceView(context: Context) : GLSurfaceView(context) {\n\n init {\n // Render the view only when there is a change in the drawing data\n renderMode = GLSurfaceView.RENDERMODE_WHEN_DIRTY\n }\n}\n```\n\n### Java\n\n```java\npublic MyGLSurfaceView(Context context) {\n ...\n // Render the view only when there is a change in the drawing data\n setRenderMode(GLSurfaceView.RENDERMODE_WHEN_DIRTY);\n}\n```\n\nExpose the rotation angle\n-------------------------\n\nThe example code above requires that you expose the rotation angle through your renderer by\nadding a public member. Since the renderer code is running on a separate thread from the main user\ninterface thread of your application, you must declare this public variable as `volatile`.\nHere is the code to declare the variable and expose the getter and setter pair: \n\n### Kotlin\n\n```kotlin\nclass MyGLRenderer4 : GLSurfaceView.Renderer {\n\n @Volatile\n var angle: Float = 0f\n}\n```\n\n### Java\n\n```java\npublic class MyGLRenderer implements GLSurfaceView.Renderer {\n ...\n\n public volatile float mAngle;\n\n public float getAngle() {\n return mAngle;\n }\n\n public void setAngle(float angle) {\n mAngle = angle;\n }\n}\n```\n\nApply rotation\n--------------\n\nTo apply the rotation generated by touch input, comment out the code that generates an angle and\nadd a variable that contains the touch input generated angle: \n\n### Kotlin\n\n```kotlin\noverride fun onDrawFrame(gl: GL10) {\n ...\n val scratch = FloatArray(16)\n\n // Create a rotation for the triangle\n // long time = SystemClock.uptimeMillis() % 4000L;\n // float angle = 0.090f * ((int) time);\n Matrix.setRotateM(rotationMatrix, 0, angle, 0f, 0f, -1.0f)\n\n // Combine the rotation matrix with the projection and camera view\n // Note that the mvpMatrix factor *must be first* in order\n // for the matrix multiplication product to be correct.\n Matrix.multiplyMM(scratch, 0, mvpMatrix, 0, rotationMatrix, 0)\n\n // Draw triangle\n triangle.draw(scratch)\n}\n```\n\n### Java\n\n```java\npublic void onDrawFrame(GL10 gl) {\n ...\n float[] scratch = new float[16];\n\n // Create a rotation for the triangle\n // long time = SystemClock.uptimeMillis() % 4000L;\n // float angle = 0.090f * ((int) time);\n Matrix.setRotateM(rotationMatrix, 0, mAngle, 0, 0, -1.0f);\n\n // Combine the rotation matrix with the projection and camera view\n // Note that the vPMatrix factor *must be first* in order\n // for the matrix multiplication product to be correct.\n Matrix.multiplyMM(scratch, 0, vPMatrix, 0, rotationMatrix, 0);\n\n // Draw triangle\n mTriangle.draw(scratch);\n}\n```\n\nWhen you have completed the steps described above, run the program and drag your finger over the\nscreen to rotate the triangle:\n\n\n**Figure 1.** Triangle being rotated with touch input (circle shows touch\nlocation)."]]