30分钟快速生成元宇宙专属虚拟人

元宇宙（Metaverse），是人类运用数字技术构建的，由现实世界映射或超越现实世界，可与现实世界交互的虚拟世界，具备新型社会体系的数字生活空间。

可见元宇宙第一步是创建专属虚拟形象，但创建3D虚拟形象需要3D基础知识。对于大部分android开发者(包括我本人)来说没有这方面的积累。难道因此我们就难以进入元宇宙的世界吗？不，今天我们借助即构平台提供的Avatar SDK，只要有Android基础即可进入最火的元宇宙世界！先看效果：

上面gif被压缩的比较狠，这里放一张截图：

1 免费注册即构开发者

前往即构控制台网站：https://console.zego.im/注册开发者账户。注册成功后，创建项目：

控制台中可以得到AppID和AppSign两个数据，这两个数据是重要凭证，后面会用到。

由于我们用到了即构的Avatar功能，但目前官方没有提供线上自动开启方式，需要主动找客服申请（当然，这是免费的），只需提供自己项目的包名，即可开通Avatar权限。打开https://doc-zh.zego.im/article/15206右下角有“联系我们”，点击即可跟客服申请免费开通权限。

注意，如果不向客服申请Avatar权限，调用AvatarSDK会失败！

2 准备开发环境

前往即构官方元宇宙开发SDK网站https://doc-zh.zego.im/article/15302下载SDK，得到如下文件列表：

接下来过程如下：

1. 打开SDK目录，将里面的ZegoAvatar.aar拷贝至app/libs目录下。
2. 添加SDK引用。打开app/build.gradle文件，在dependencies节点引入 libs下所有的jar和aar:

dependencies {
 
    implementation fileTree(dir: 'libs', include: ['*.jar', "*.aar"]) //通配引入
    
    //其他略
}

3. 设置权限。根据实际应用需要，设置应用所需权限。进入app/src/main/AndroidManifest.xml 文件，添加权限。

<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.BLUETOOTH" />
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />

<uses-feature
    android:glEsVersion="0x00020000"
    android:required="true" />
<uses-feature android:name="android.hardware.camera" />
<uses-feature android:name="android.hardware.camera.autofocus" />

因为Android 6.0在一些比较重要的权限上要求必须申请动态权限，不能只通过 AndroidMainfest.xml文件申请静态权限。具体动态请求权限代码可看附件源码。

3 导入资源

上一小节下载的zip文件中，有个assets目录。里面包含了Avatar形象相关资源，如：衣服、眉毛、鞋子等。这是即构官方免费提供的资源，可以满足一般性需求了。当然了，如果想要自己定制资源也是可以的。assets文件内容如下：

资源名称	说明
AIModel.bundle	Avatar 的 AI 模型资源。当使用表情随动、声音随动、AI 捏脸等能力时，必须先将该资源的绝对路径设置给 Avatar SDK。
base.bundle	美术资源，包含基础 3D 人物模型资源、资源映射表、人物模型默认外形等。
Packages	美妆、挂件、装饰等资源。 每个资源 200 KB ~ 1 MB 不等，跟资源复杂度相关。

注意：由于资源文件很大，上面下载的美术资源只包含少量必须资源。如果需要全部资源，可以去官网找客服索要：https://doc-zh.zego.im/article/14882

上面的文件需要存放到Android本地SDCard上，这里有2个方案可供参考：

• 方案一： 将资源先放入到app/src/assets目录内，然后在app启动时，自动将assets的内容拷贝到SDcard中。
• 方案二： 将资源放入到服务器端，运行时自动从服务器端下载。

为了简单起见，我们这里采用方案一。参考代码如下, 详细代码可以看附件：

AssetsFileTransfer.copyAssetsDir2Phone(this.getApplication(),
            "AIModel.bundle", "assets");
AssetsFileTransfer.copyAssetsDir2Phone(this.getApplication(),
            "base.bundle", "assets");
AssetsFileTransfer.copyAssetsDir2Phone(this.getApplication(),
            "Packages", "assets");

4 创建虚拟形象

创建虚拟形象本质上来说就是调用即构的Avatar SDK，其大致流程如下：

接下来我们逐步实现上面流程。

需要注意的是，上面示意图中采用的是AvatarView，可以非常方便的直接展示Avatar形象，但是不方便后期将画面通过RTC实时传递， 因此，我们后面的具体实现视通过TextureView替代AvatarView。

4.1 申请权鉴

这里再次强调一下，一定要打开https://doc-zh.zego.im/article/15206点击右下角有“联系我们”，向客服申请免费开通Avatar权限。否则无法使用Avatar SDK。

申请权鉴代码如下：

public class KeyCenter {
    
    // 控制台地址: https://console.zego.im/dashboard 
    public static long APP_ID = 这里值可以在控制台查询，参考第一节;  //这里填写APPID
    public static String APP_SIGN =  这里值可以在控制台查询，参考第一节; 
    // 鉴权服务器的地址
    public final static String BACKEND_API_URL = "https://aieffects-api.zego.im?Action=DescribeAvatarLicense";

    public static String avatarLicense = null;
    public static String getURL(String authInfo) {
   
        Uri.Builder builder = Uri.parse(BACKEND_API_URL).buildUpon();
        builder.appendQueryParameter("AppId", String.valueOf(APP_ID));
        builder.appendQueryParameter("AuthInfo", authInfo);

        return builder.build().toString();
    }

    public interface IGetLicenseCallback {
   
        void onGetLicense(int code, String message, ZegoLicense license);
    }

    /**
     * 在线拉取 license
     * @param context
     * @param callback
     */
    public static void getLicense(Context context, final IGetLicenseCallback callback) {
   
        requestLicense(ZegoAvatarService