一、需求背景

新项目开发，需预置“天翼云电脑”app，云电脑app界面里其实就是盒子端接入的鼠标和键盘外设，来操作云端的windows系统桌面；

云电脑客户端使用的android系统本地的鼠标光标，而远端光标(云桌面windows系统里的鼠标光标)发生变更时会把新的光标图标传递给客户端，让客户端使用这个图标更新本地鼠标光标；

但是android7.0以下应用层没有可以变更鼠标光标的API，所以如果设备时android7.0以下的系统，需要厂家另行添加变更本地鼠标光标的API供云电脑app调用；

例如如下图这种情况：

当鼠标移动到窗口边缘时，需要将鼠标光标替换为双箭头图标

image.png

image.png

二、需求接口定义

系统与应用约定，通过AIDL实现

setPointerIcon(Bitmap bitmap, int hotSpotX, int hotSpotY)和clear()

两个函数，来实现替换和恢复系统光标

// IPointerIconService.aidl

package com.chinatelecom.clouddesk;

import android.graphics.Bitmap;

// Declare any non-default types here with import statements

interface IPointerIconService {

/*

** 设置自定义的鼠标光标图片

** @params:

** bitmap: 自定义光标图片。目前云电脑使用的鼠标标准鼠标光标图标大小为32*32左右，其大小不会超过100*100。

** hotSpotX: 图标在鼠标光标X轴绝对位置上的相对偏移量

** hotSpotY: 图标在鼠标光标Y轴绝对位置上的相对偏移量

*/

void setPointerIcon(in Bitmap bitmap, int hotSpotX, int hotSpotY);

//清除自定义鼠标图片的引用,恢复使用系统默认的鼠标图标光标

void clear();

}

期望的绑定方式：

Intent intent = new Intent("com.chinatelecom.clouddesk.IPointerIconService");

intent.setPackage("com.chinatelecom.clouddesk");

if (!bindService(intent, mConnection, Context.BIND_AUTO_CREATE)) {

Log.e("tanz", "Could not bind to IPointerIconService with "+intent);

}

注：系统侧需调测bitmap状态为recycled以及bitmap状态为null时的情形，以免出现此类异常时系统稳定性出问题。

三、需求实现思路

阅读源码发现，系统鼠标光标是在开机时由

frameworks\base\services\input\InputReader.cpp

中调用obtainPointerController函数创建指针控制器

image.png

\frameworks\base\services\jni\com_android_server_input_InputManagerService.cpp

的obtainPointerController函数中创建指针控制器，并给指针控制器赋值光标bitmap图标资源

9505430-63bfb23999f169c6.png

从上图可以看出PointerIcon实例是通过 JNI Native callback回调到InputManagerService.java中的getPointerIcon()函数来获取；

image.png

而且通过读上述阅读源码发现，com_android_server_input_InputManagerService.cpp中PointerController只实例化一次

那么我们就有了大致思路：

云电脑通过aidl将bitmap和偏移量传递AIDL服务

AIDL服务通过广播将bitmap和偏移量传递给InputManagerService.java

InputManagerService中使用拿到的bitmap和偏移量，创建新的PointerIcon

然后InputManagerService.java通过JNI通知C层刷新鼠标光标

C层中的单例PointerController去set新创建的PointerIcon即可完成光标替换

四、功能具体实现

步骤一：实现AIDL服务和接口函数

实现AIDL服务和clear()、setPointerIcon()两个函数

clear()函数：发“com.pointer.clear”广播

setPointerIcon()函数：发“com.pointer.change”广播

并将bitmap、hotSpotX、hotSpotY通过Bundle传递

package com.chinatelecom.clouddesk;

import android.app.Service;

import android.content.Context;

import android.content.Intent;

import android.graphics.Bitmap;

import android.os.Bundle;

import android.os.IBinder;

import android.os.RemoteException;

import android.util.Log;

/**

* 作者:libeibei

* 创建日期:20201109

* 类说明:

* API:setPointerIcon for telecom clouddesk

* logcat -v time |grep -e InputManager -e InputReader -e PointerController

**/

public class PointerIconService extends Service {

private static final String TAG = "CH_InputManager";

Context mContext = null;

Intent intent = null;

Bundle bundle = null;

@Override

public IBinder onBind(Intent intent) {

Log.i(TAG, "-----> onBind() ……");

mContext = PointerIconService.this.getApplicationContext();

return new PointerIconStub();

}

@Override

public boolean onUnbind(Intent intent) {

return super.onUnbind(intent);

}

private class PointerIconStub extends IPointerIconService.Stub {

@Override

public void clear() throws RemoteException {

Log.i(TAG, "-----> clear()");

intent = new Intent("com.pointer.clear");

sendBroadcast(intent);

}

@Override

public void setPointerIcon(Bitmap bitmap, int hotSpotX, int hotSpotY) throws RemoteException {

Log.i(TAG, "-----> setPointerIcon()");

if (bitmap == null) {

Log.i(TAG, "-----> bitmap is null , cancel");

} else if (bitmap.isRecycled()) {

Log.i(TAG, "-----> bitmap is isRecycled , cancel");

} else {

intent = new Intent("com.pointer.change");

bundle = new Bundle();

bundle.putParcelable("bitmap", bitmap);

bundle.putFloat("hotSpotX", (float) hotSpotX);

bundle.putFloat("hotSpotY", (float) hotSpotY);

intent.putExtras(bundle);

sendBroadcast(intent);

}

}

}

}

步骤二：InputManagerService接收广播

新增静态变量：static int Icon_Type = 0;

当接收到clear()函数发送的“com.pointer.clear”广播时

将Icon_Type = 0

当接收到setPointerIcon()函数发送的“com.pointer.change”广播时

将Icon_Type = 1

并调用setSystemUiVisibility()Native函数

(这里也可以新增Jni native函数来通知下面，不过我这边测试发现调用setSystemUiVisibility不影响其他功能就直接用这个函数了)

来通知com_android_server_input_InputManagerService.cpp中的

PointerIconController来更新Icon

frameworks\base\services\java\com\android\server\input\InputManagerService.java

// libeibei add for change pointer begin

private void registerPointerReceiver() {

IntentFilter pointerFilter = new IntentFilter();

pointerFilter.addAction("com.pointer.clear");

pointerFilter.addAction("com.pointer.change");

mContext.registerReceiver(pointerReceiver, pointerFilter);

}

static int Icon_Type = 0;

static Bitmap bitmap = null;

static float hotSpotX = 0;

static float hotSpotY = 0;

static Bundle mBundle = null;

BroadcastReceiver pointerReceiver = new BroadcastReceiver() {

@Override

public void onReceive(Context context, Intent intent) {

if (intent.getAction().equals("com.pointer.clear")) {

Log.i(TAG, "-----> onReceive clear");

Icon_Type = 0;

bitmap = null;

hotSpotX = 0;

hotSpotY = 0;

setSystemUiVisibility(0);

}

if (intent.getAction().equals("com.pointer.change")) {

Log.i(TAG, "-----> onReceive change");

mBundle = intent.getExtras();

if (mBundle != null) {

Icon_Type = 1;

bitmap = (Bitmap) mBundle.getParcelable("bitmap");

hotSpotX = mBundle.getFloat("hotSpotX");

hotSpotY = mBundle.getFloat("hotSpotY");

Log.i(TAG, "-----> hotSpotX = " + hotSpotX + ",hotSpotY = " + hotSpotY);

setSystemUiVisibility(1);

} else {

Log.i(TAG, "-----> mBundle = null");

Icon_Type = 0;

bitmap = null;

hotSpotX = 0;

hotSpotY = 0;

setSystemUiVisibility(0);

}

}

}

};

// libeibei add for change pointer end

并修改getPointerIcon()函数

当Icon_Type=1时获取使用bundle传递的bitmap创建新的图标

当Icon_Type=0时获取系统默认光标

将getPointerIcon()函数按照上述思路修改，如下：

image.png

步骤三：修改com_android_server_input_InputManagerService.cpp更新PointerIcon

image.png

有之前上面源码分析可知 obtainPointerController函数中

pointerController只创建一次，且由锁持有

所以我们在函数中获取需要获取pointerController实例时，要加锁

注意1：这也是我步骤二中没有新建JNI接口的原因，查看源码发现setSystemUiVisibility()函数已经加锁，并对pointerController进行操作，所以直接在setSystemUiVisibility做了修改

注意2：当然具体项目不同可能代码有差异，如果修改setSystemUiVisibility()函数会对系统有影响，就需要自己实现JNI接口了，总之新实现的函数别忘了持有锁

setSystemUiVisibility()函数修改前

image.png

setSystemUiVisibility()函数修改后

获取pointerController实例，对controller进行setPointerIcon操作来替换资源

image.png

自测试界面，调用两个接口测试OK：

ezgif-7-386343925533.gif

以上为Android 4.4.2 系统，添加自定义系统鼠标光标接口的分析流程和实现步骤

不同android版本可能这部分代码有些差异，但是总体思路不会变化

天翼云电脑的对接绕不开鼠标光标问题，应该后续很多电信的项目有对接云电脑的需求

如有其他友商需实现，可参考该实现方法