HBuilder基座和自定义基座差别

Posted

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了HBuilder基座和自定义基座差别相关的知识,希望对你有一定的参考价值。

参考技术A (1) 点击菜单栏“运行”->“运行到手机或模拟器”,会在手机/模拟器上安装“HBuilder”应用(或者叫HBuilder基座),在应用开发过程中HBuilder/HBuilderX会将应用资源实时同步到基座并刷新,从而实时查看到修改效果。
(2) 这里的“HBuilder”应用(或者叫HBuilder基座)使用的是DCloud申请的第三方SDK配置,开发者设置的第三方SDK配置信息不会生效。如微信分享,分享后显示的来源一定是“HBuilder”。如果开发者希望自己申请的第三方SDK配置生效,则需使用自定义基座,在应用中调用 uni-app原生插件 也必须使用自定义基座。

(1) 自定义基座是使用开发者申请的第三方SDK配置生成的基座应用,用于HBuilder/HBuilderX开发应用时实时在手机/模拟器上查看运行效果
(2) 在HBuilder/HBuilderX中点击菜单栏“运行->运行到手机或模拟器->制作自定义基座”生成自定义基座安装包

(3) 打包成功后需要点击菜单栏“运行->运行到手机或模拟器->运行基座选择->自定义基座”来开启自定义基座功能
(4) 点击菜单栏“运行”->“运行到手机或模拟器”,可实时在手机上查看运行效果

(1) uni-app原生插件
必须使用自定义基座,HBuilder基座不支持调用uni-app原生插件。
(2) 地图
应用运行显示效果无差别,地图的配置信息只是校验开发者的合法性。
(3) 登录鉴权
授权页面显示效果不同,HBuilder基座显示的是“HBuilder”应用,自定义基座显示的是开发者配置的应用信息。
(4) 支付

(5) 推送
HBuilder基座需要使用DCloud账号登录推送平台才能下发推送消息(目前开发者无法在此环境下发推送消息)。
如果需要调试推送业务,则需要使用自定义基座,开发者登录到推送平台下发推送消息。
(6) 分享
分享后显示效果不同,HBuilder基座显示的分享来源是“HBuilder”应用,自定义基座显示的分享来源是开发者配置的应用信息。
(7) 语音识别

(8) 统计
HBuilder基座所有统计数据提交到DCloud申请的统计平台账号下。自定义基座统计数据提交到开发者申请的统计平台账号下。
备注 :使用自定义基座各种SDK配置才能生效, 但是使用自定义基座进行云端打包后,HX提示【自定义基座不可用于正式发布,其脱离HBuilderX无法更新应用资源】,手机安装打出来的包提示【当前应用运行在测试环境,发布正式版请打正式包】。原因是自定义基座和HBuilder自带基座都是用于开发调试。使用自定义基座开发调试uni-app原生插件后,不可直接将自定义基座apk作为正式版发布。云打包时若勾选了“自定义基座”,打出来的是测试包;应该重新提交云端打包( 不能勾选“自定义基座” )生成正式版本,正式包的SDK配置会自动生效。

uni-app技术分享| uni-app常见问题

1. 运行无法使用插件

  • 查看控制台提示是否存在以下提示, 请根据控制台提示操作

    [JS Framework] 当前运行的基座不包含原生插件[AR-RtcModule],请在manifest中配置该插件,重新制作包括该原生插件的自定义运行基座
  • 使用的是 标准运行基座

    • 需要制作自定义运行基座
    • 运行时选择自定义基座运行(HBuilder 默认标准运行基座)
  • 插件仅支持 APP;

2.场景使用

3.用户 uid 与自身业务结合

  • 用户 uid:
    • 必须为字符串
    • 标识用户,独一无二
    • 不能设置为中文
    • 长度在 64 字节以内的字符串,范围(26 个小写字母 a-z;26 个大写字母 A-Z;10 个数字 0-9;空格;"!", "#", "$", "%", "&", "(", ")", "+", "-", ":", ";", "<", "=", ".", ">", "?", "@", "[", "]", "^", "*", "", "", "|", "~", ",";等)
    • 可使用自身业务 id,但必须符合用户 uid

4.频道房间 channelId 与自身业务结合

与 uid 需求一致;

5.token 相关

调试项目时建议暂不开启
appid 开启 token 校验时,加入频道时必须要填入

6.加入频道,设置 uid 或 channelId

加入房间前进行设置

  rtcModule.joinChannel(
            "token": 开启 token 校验时填入(必须字符串)|| ,
            "channelId": 自行设置(必须字符串)|| ,
            "uid": 自行设置(必须字符串)|| ,
        , (res) => 
            console.log(RTC joinChannel 方法调用, (res.code === 0 ? 成功 : 失败:) + res);
        );

7.功能第一次有效,在次操作发生错误

  • 重复创建实例(多在调试阶段出现),多次调用 rtmModule.createInstance
    • 每次都要重启应用
    • 功能结束后要销毁对应实例

8.ios、Android 意外闪退

查看方法参数是否符合,如:

  • rtcModule.joinChannel 的参数 uid 设置的不是字符串
    ...

9.无画面、无声音

  • 查看手机权限是否开启

  • 音视频页面必须是nvue页面

  • 本地视频渲染:

    <AR-CanvasView ref="location" style="flex: 1;" />
    • 必须要获取到视频容器
    • 调用对应方法
    this.$refs.location.setupLocalVideo(
                "renderMode": 1,
                "channelId": 同一个房间,
                "uid": 用户 uid,
                "mirrorMode": 0
            , (res) => 
                console.log(渲染视频, res);
            );
            // 本地预览
    this.$refs.location.startPreview((res) => 
                console.log(本地预览, res);
            )
  • 远端视频渲染:
    1.通过远端视频首帧回调 onFirstRemoteVideoDecoded
    2.然后显示远端视频容器

       <AR-CanvasView ref="remote" style="flex: 1;" />

    3.对应方法(必须要获取远端视频容器)

      this.$refs.remote.setupRemoteVideo(
            "renderMode": 1,
            "channelId": 同一个房间,
            "uid":远端 uid,
            "mirrorMode": 0
        , (res) => 
            console.log(渲染远端视频, res);
        )

10.uniapp 在通信过程中获取对方的网络状态

插件仅能通过 anyRTC实时消息SDK插件 获取对应用户状态: 在线/不在线
如需获取更详细的网络状态:
uni.onNetworkStatusChange 获取网络
通过 实时消息SDK插件 ,向对方发送信息
对方收到后,在将网络信息返回给查询者

11.多人视频展示

每一位用户都有自己的视频容器
渲染视频时必须获取到对应容器

12.是否可转换多端

  • 使用插件仅支持App
  • 如需转成小程序,可使用 Web SDK进行转换(建议使用小程序对应的sdk)

以上是关于HBuilder基座和自定义基座差别的主要内容,如果未能解决你的问题,请参考以下文章

uni-app技术分享| uni-app常见问题

uni-app技术分享| uni-app常见问题

uni-app App端 如何自定义基座调式

uniapp自定义基座真机调试

IOS设备安装UNI-APP(调试基座)步骤

七、uni-app 原生插件开发03 - 制作自定义基座