在 Java Runtime 2.0.0 for Series 40 版本中添加了對(duì)多點(diǎn)觸摸API的支持，那么本文的目的就是介紹如何使用多點(diǎn)觸摸API，處理交互的事件。

多點(diǎn)觸摸API允許在基于Canvas的MIDlet中處理多點(diǎn)觸摸事件，比如說(shuō)GameCanvas， FullCanvas等，通過(guò)API我們可以注冊(cè)以便能夠接收到多點(diǎn)觸摸事件。

API介紹

每一個(gè)觸摸點(diǎn)是包括3個(gè)重要的數(shù)值：

一個(gè)唯一的ID

當(dāng)前的坐標(biāo)值，包括X， Y

當(dāng)前觸點(diǎn)的狀態(tài)

其中觸摸的狀態(tài)有3種：

POINTER_PRESSED

POINTER_DRAGGED

POINTER_RELEASED

多點(diǎn)觸摸的API很簡(jiǎn)單，主要包括了下面的：

-MultipointTouch 該類主要用來(lái)訪問(wèn)多個(gè)觸電的相關(guān)坐標(biāo)，狀態(tài)等信息，設(shè)備所支持的觸點(diǎn)數(shù)等信息，綁定或移除多點(diǎn)觸摸監(jiān)聽(tīng)者等。

-MultipointTouchListener 接收多點(diǎn)觸摸事件，并做出相應(yīng)處理。

API的使用

判斷當(dāng)前設(shè)備是否支持 MultiTouch API

Nokia SDK中提供了屬性com.nokia.mid.ui.multipointtouch.version 來(lái)獲取API版本信息。

if (System.getProperty("com.nokia.mid.ui.multipointtouch.version") != null) {
    // API is supported: Can implement multipoint touch functionality
} else {
    // API is not supported: Cannot implement multipoint touch functionality
}

如何獲取特定設(shè)備所支持的最大觸點(diǎn)數(shù)呢： 可以使用- MultipointTouch.getMaxPointers

獲取MultipointTouch實(shí)例

MultipointTouch mpt = MultipointTouch.getInstance();

為MIDlet注冊(cè)MultipointTouchListener

public class MainCanvas extends Canvas implements MultipointTouchListener
{
    public MainCanvas() {
        // ...
        mpt.addMultipointTouchListener(this);
    }
......
}

處理多點(diǎn)觸摸事件

從函數(shù)pointersChanged(int[] pointerIds)可以看出參數(shù)僅僅是一個(gè)觸摸點(diǎn)ID的數(shù)組，然后我們是通過(guò)ID值使用MultipointTouch來(lái)獲取觸點(diǎn)的相關(guān)信息。 

這里需要注意的，參數(shù)pointerIds 這個(gè)數(shù)組僅僅是包含了狀態(tài)，位置有變化的觸摸點(diǎn)的ID，沒(méi)有變化的并不會(huì)被包含在該數(shù)組中。

public void pointersChanged(int[] pointerIds) {
    for(int i=0; i<pointerIds.length; i++) {        // Loop through the changed touch points
    {
        int pointerId = pointerIds[i];              // Get the touch point ID
        int state = MultipointTouch.getState(pointerId);  // Get the touch point state
        // Get the touch point x and y coordinates
        int x = MultipointTouch.getX(pointerId); 
        int y = MultipointTouch.getY(pointerId);
 
        // Handle the UI update based on the touch point state, ID and coordinates
        switch(state) {
            case MultipointTouch.POINTER_PRESSED:   // A new finger was pressed against the screen
                drawTouch(pointerId, x, y); break;
            case MultipointTouch.POINTER_DRAGGED:   // A pressed finger was dragged over the screen
                drawTouch(pointerId, x, y); break;
            case MultipointTouch.POINTER_RELEASED:  // A pressed finger was lifted from the screen
                break; 
                 } 
             } 
        }

實(shí)例演示