tencent cloud

文档反馈

uni-app 常见问题

最后更新时间:2024-09-05 15:12:37

    常见问题

    什么是 UserSig?

    UserSig 是用户登录即时通信 IM 的密码,其本质是对 UserID 等信息加密后得到的密文。

    如何生成 UserSig?

    UserSig 签发方式是将 UserSig 的计算代码集成到您的服务端,并提供面向项目的接口,在需要 UserSig 时由您的项目向业务服务器发起请求获取动态 UserSig。更多详情请参见 生成 UserSig
    注意
    chat-uikit-uniapp 快速入门中采用的 UserSig 获取方案是在本地代码中配置 SECRETKEY,该方法中 SECRETKEY 很容易被反编译逆向破解,一旦您的密钥泄露,攻击者就可以盗用您的腾讯云流量,因此该方法仅适合本地跑通功能调试。 正确的 UserSig 签发方式请参见上文。

    TUIKit 使用 typescript 开发,是否支持在 javascript 项目中集成?

    此项目使用 ts 开发,同时也支持 js 项目直接集成。

    是否支持 vue-cli 创建的工程中集成?

    暂时不支持 vue-cli 创建的工程。

    uni-app 构建 native app 发送语音消息时间显示错误怎么办?

    uni-app 构建 native app时,recorderManager.onStop 回调中没有 durationfileSize,需要用户自己补充 duration 和 fileSize。
    通过 setInterval 记录时间,计算出 duration。
    本地计算文件大小,文件大小 = (音频码率) × 时间长度(单位:秒) / 8,粗略估算。 详细代码请参见 uni-app TUIKit 源码 实现。
    注意
    语音消息对象中必须包括 durationfileSize,如果没有 fileSize,语音消息时长是一串错误的数字。

    如何实现文件消息上传?

    uni-app 官方文档 提示 chooseFile 不支持 APP 选择非媒体文件。故客户根据自己的需求在 插件市场 选择可用插件。
    可参考插件库可用插件:iOS 上传文件插件安卓上传文件插件 (非官方)完成文件选择 ,并格式化数据符合文件消息数据格式要求。
    file 参数如下表所示:
    参数
    类型
    含义
    name
    String
    文件名(必要)
    size
    Number
    文件大小 (必要,不能为0)
    type
    String
    文件类型 (必要)
    path
    String
    文件路径 (必要)
    lastModified
    String
    修改时间 (非不要)
    参考示例格式:
    const fileData = {
    files: [
    {
    name: '', // 文件名
    size: 10, //本地文件大小
    type: 'pdf', //文件类型
    path: '', //本地文件路径
    lastModified: '', // 修改时间
    },
    ],
    };

    如何运行在小程序端时选择运行时压缩代码?

    
    
    

    运行在小程序端出现异常报错怎么办?

    可能和微信开发者工具版本有关,请使用最新的开发者工具,以及确认稳定的调试基础库版本。

    引入原生音视频插件报以下错怎么办?

    
    
    根据 uni-app 原生插件调试 制作 自定义基座

    HBuilder 报错: SyntaxError: Unexpected token '.',怎么办?

    如果按照以上接入步骤接入运行后,出现以下错误信息。则说明您当前的 HBuilder 版本过低,请升级至最新版本。
    
    截屏2023-08-11 14 28 54
    
    

    uniapp 构建后白屏,并提示 [Vue warn]: Property or method "isPC" is not defined,怎么处理?

    请参考文档:快速入门(uniapp)
    请在参考上述内容后,并在main.js文件中引入VueCompositionAPI,并Vue.use(VueCompositionAPI),如下图所示:
    import VueCompositionAPI from "@vue/composition-api";
    Vue.use(VueCompositionAPI);
    
    
    

    按照文档集成小程序后点击“打开TUIKIT会话”,页面只有发起会话,其余内容白屏,没有会话列表,如何解决?

    请参考文档:快速入门(uniapp)TUIKIT源码集成/步骤2:下载并引入TUIKit/集成TUIKit组件,请严格按照该部分的四个步骤依次进行集成,尤其是最后一项“小程序分包首页”。
    说明:
    小程序默认按照分包流程进行集成,以避免首包过大,因此,如果您希望打包小程序,请不要跳过“小程序分包首页”的配置。

    打包小程序, 请在项目 manifest.json > 微信小程序配置,勾选以下选项

    
    
    

    小程序如果需要上线或者部署正式环境怎么办?

    请在微信公众平台 > 开发 > 开发管理 > 开发设置 > 服务器域名中进行域名配置:
    从v2.11.2起 SDK 支持了 WebSocket,WebSocket 版本须添加以下域名到 socket 合法域名
    域名
    说明
    是否必须
    wss://wss.im.qcloud.com
    Web IM 业务域名
    必须
    wss://wss.tim.qq.com
    Web IM 业务域名
    必须
    将以下域名添加到 request 合法域名
    域名
    说明
    是否必须
    https://web.sdk.qcloud.com
    Web IM 业务域名
    必须
    https://webim.tim.qq.com
    Web IM 业务域名
    必须
    https://api.im.qcloud.com
    Web IM 业务域名
    必须
    将以下域名添加到 uploadFile 合法域名
    域名
    说明
    是否必须
    https://cos.ap-shanghai.myqcloud.com
    文件上传域名
    必须
    https://cos.ap-shanghai.tencentcos.cn
    文件上传域名
    必须
    https://cos.ap-guangzhou.myqcloud.com
    文件上传域名
    必须
    将以下域名添加到 downloadFile 合法域名
    域名
    说明
    是否必须
    https://cos.ap-shanghai.myqcloud.com
    文件下载域名
    必须
    https://cos.ap-shanghai.tencentcos.cn
    文件下载域名
    必须
    https://cos.ap-guangzhou.myqcloud.com
    文件下载域名
    必须

    参考文档

    UIKit (vue2 / vue3)相关:
    ChatEngine 相关:

    技术咨询

    点此进入 IM 社群,享有专业工程师的支持,解决您的难题。
    联系我们

    联系我们,为您的业务提供专属服务。

    技术支持

    如果你想寻求进一步的帮助,通过工单与我们进行联络。我们提供7x24的工单服务。

    7x24 电话支持