更新记录

1.0.0（2026-11-08）

新版发布。

平台兼容性

uni-app(4.64)

uni-app x(4.87)

企业微信授权登录和分享UTS插件接口文档

注意：

A、管理员登录企业微信管理后台，选择企业应用

B、选择已有应用或添加应用，进入应用详情页面。

C、选择“企业微信授权登录”，在设置界面填写Android的签名&包名、iOS的BundleID和HarmonyOS的AppID&BundleID，设置完成后系统自动生成应用程序schema。

1. 企业微信授权登录和分享UTS插件

<script>

    //企业微信授权登录和分享UTS插件
    import * as Wework from "@/uni_modules/Lizii-Wework";

    export default {
    }

</script>

2. 初始化注册到企业微信(必须)，onLoad中调用一次即可

<script>

    //企业微信授权登录和分享UTS插件
    import * as Wework from "@/uni_modules/Lizii-Wework";

    export default {

        onLoad() {

            //初始化注册到企业微信
            let schema = "wwauth1e933be11645237c00xxxx";//应用跳转标识，显示在具体应用下的 Schema字段
            let appid = "WW1e933be11645xxxx";//企业唯一标识。创建企业后显示在，我的企业 CorpID字段
            let agentid = "100xxxx";//应用唯一标识。显示在具体应用下的 AgentId字段
            Wework.registerApp(schema, appid, agentid);
        }
    }

</script>

3. 取消注册

//取消注册
Wework.unregisterApp();

4. 是否安装企业微信

//是否安装企业微信
let ret = Wework.isWWAppInstalled();//已安装(true) 未安装(false)

5. 授权登录

//授权登录
let state = "test12345678";//用于保持请求和回调的状态，授权请求后原样带回给第三方。建议设置为简单的随机数加session进行校验
Wework.auth(state, function(res){
    console.log(res);
    let state = res.state;//状态原样返回
    let errCode = res.errCode;//错误码
    if (errCode == 0) {
        //成功
        let code = res.code;//授权临时票据
    } else if (errCode == 1) {
        //取消
    } else {
        //错误
        let errMsg = res.errMsg;//错误消息
    }
});

6、分享文本（支持Android和iOS，不支持鸿蒙）

//分享文本
let text = "分享文本测试";
Wework.shareText(text);

7、分享图片

//分享图片
let filename = "logo.png";
let path = Wework.convert2AbsFullPath("_www/static/logo.png");
Wework.shareImage(filename, path);

8、分享文件

//分享文件
let filename = "readme.pdf";
let path = Wework.convert2AbsFullPath("_www/static/readme.pdf");
Wework.shareFile(filename, path);

9、分享视频（支持Android和iOS，不支持鸿蒙）

//选择视频
uni.chooseVideo({
    count: 1, 
    sizeType: ['original', 'compressed'],
    sourceType: ['camera','album'], //从相册选择
    success: function (res) {
        let videoPath = Wework.convert2AbsFullPath(res.tempFilePath);
        console.log(videoPath);
        //分享视频
        let filename = "video.mp4";
        Wework.shareVideo(filename, videoPath);
    }
});

10、分享链接

//分享链接
let thumbUrl = "https://www.baidu.com/img/flexible/logo/pc/result@2.png";
let webpageUrl = "https://www.baidu.com";
let title = "测试标题";
let description = "测试描述";
Wework.shareLink(thumbUrl, webpageUrl, title, description);

11、分享小程序

//分享小程序
let imageBase64 = "";
Wework.shareMiniProgram({
    username:"gh_dde54cb88ce7@app",//必须是应用关联的小程序，注意要有@app后缀
    title:"测试_MaHow",
    hdImageData:imageBase64,//图片base64(不带头)
    path:"/pages/plugin/index.html?plugid=1cbd3b7c8674e61769436b5e354ddb2f"
});

12、【iOS端】在manifest.json配置中，ios设置, UrlScheme设置 应用跳转标识，显示在具体应用下的 Schema字段

/* ios打包配置 */
"ios" : {
    "urltypes" : "wwauth1e933be11645237c00xxxx"
}

13、【鸿蒙端】在harmony-configs/entry/src/main/module.json5文件中设置querySchemes

在harmony-configs/entry/src/main/module.json5文件中设置
{
    "module": {
        ...
        "querySchemes": [
            "wxworkapi",
            "https"
        ]
    }
}