一、需求背景

新项目开发，需预置“天翼云电脑”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服务与InputManagerService.java通信，将bitmap和偏移量传递过来，InputManagerService.java中创建新的PointerIcon；
然后InputManagerService.java通过JNI通知com_android_server_input_InputManagerService.cpp中的单例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版本可能这部分代码有些差异，但是总体思路不会变化
天翼云电脑的对接绕不开鼠标光标问题，应该后续很多电信的项目有对接云电脑的需求
如有其他友商需实现，可参考该实现方法