如何使用遥控器DPad在Android TV应用中实现Google Map平移导航？

核心实现思路 #

利用DPad方向键触发地图平移，通过地图SDK的投影工具，将屏幕像素偏移转换为地理坐标偏移，最终移动地图相机完成平移。以下以Google Maps SDK为例，其他地图SDK（高德、百度等）逻辑通用。

具体代码实现 #

首先持有地图实例引用，并定义单次平移的像素距离：

private GoogleMap mMap;
private static final float PAN_STEP_PX = 120f; // 单次平移像素，可根据TV屏幕大小调整

然后在按键事件处理中填充平移逻辑：

switch (keyCode) {
    case KeyEvent.KEYCODE_DPAD_UP:
        if (mMap != null) {
            panMap(0, -PAN_STEP_PX);
        }
        return true;
    case KeyEvent.KEYCODE_DPAD_DOWN:
        if (mMap != null) {
            panMap(0, PAN_STEP_PX);
        }
        return true;
    case KeyEvent.KEYCODE_DPAD_LEFT:
        if (mMap != null) {
            panMap(-PAN_STEP_PX, 0);
        }
        return true;
    case KeyEvent.KEYCODE_DPAD_RIGHT:
        if (mMap != null) {
            panMap(PAN_STEP_PX, 0);
        }
        return true;
    default:
        return false;
}

// 封装平移逻辑
private void panMap(float dx, float dy) {
    CameraPosition currentPos = mMap.getCameraPosition();
    Projection projection = mMap.getProjection();
    // 将当前地图中心点转换为屏幕坐标
    Point centerPoint = projection.toScreenLocation(currentPos.target);
    // 计算偏移后的屏幕坐标
    Point newCenterPoint = new Point(
        (int) (centerPoint.x + dx),
        (int) (centerPoint.y + dy)
    );
    // 将偏移后的屏幕坐标转回地理坐标
    LatLng newTarget = projection.fromScreenLocation(newCenterPoint);
    // 移动地图到新的中心点
    mMap.moveCamera(CameraUpdateFactory.newLatLng(newTarget));
}

优化体验的扩展方案 #

1. 动态调整平移步长：根据地图缩放级别调整平移幅度，缩放级别越高（地图越近），步长越小，避免移动幅度过大：

private float getAdjustedPanStep() {
    if (mMap == null) return PAN_STEP_PX;
    float zoom = mMap.getCameraPosition().zoom;
    // 缩放级别每增加1，步长减半，可根据需求调整比例
    return PAN_STEP_PX / (zoom - 10f);
}

2. 长按连续平移：实现长按方向键时地图持续平移，提升操作流畅度：

private Handler mPanHandler = new Handler(Looper.getMainLooper());
private boolean isLongPressActive = false;
private int currentPressedKey;

@Override
public boolean onKeyDown(int keyCode, KeyEvent event) {
    if (event.getRepeatCount() == 0) {
        isLongPressActive = true;
        currentPressedKey = keyCode;
        // 延迟触发连续平移，避免误触
        mPanHandler.postDelayed(continuousPanRunnable, 300);
    }
    // 先执行一次单次平移
    handleDpadKey(keyCode);
    return true;
}

@Override
public boolean onKeyUp(int keyCode, KeyEvent event) {
    isLongPressActive = false;
    mPanHandler.removeCallbacks(continuousPanRunnable);
    return true;
}

private Runnable continuousPanRunnable = new Runnable() {
    @Override
    public void run() {
        if (isLongPressActive) {
            handleDpadKey(currentPressedKey);
            // 每隔100ms执行一次平移，控制连续移动速度
            mPanHandler.postDelayed(this, 100);
        }
    }
};

// 将之前的switch逻辑封装到该方法
private boolean handleDpadKey(int keyCode) {
    switch (keyCode) {
        case KeyEvent.KEYCODE_DPAD_UP:
            if (mMap != null) panMap(0, -getAdjustedPanStep());
            return true;
        case KeyEvent.KEYCODE_DPAD_DOWN:
            if (mMap != null) panMap(0, getAdjustedPanStep());
            return true;
        case KeyEvent.KEYCODE_DPAD_LEFT:
            if (mMap != null) panMap(-getAdjustedPanStep(), 0);
            return true;
        case KeyEvent.KEYCODE_DPAD_RIGHT:
            if (mMap != null) panMap(getAdjustedPanStep(), 0);
            return true;
        default:
            return false;
    }
}

注意事项 #

• 确保地图实例已初始化完成（如在onMapReady回调后再处理按键事件），避免空指针异常。
• 不同地图SDK的投影API名称可能略有差异，但核心逻辑都是屏幕坐标与地理坐标的互相转换，可参考对应SDK的官方文档调整。

内容的提问来源于stack exchange，提问作者Aakshansh