DCloud_heavensoft
DCloud_heavensoft
  • 发布:2018-09-20 06:55
  • 更新:2024-07-10 09:30
  • 阅读:172543

uni-app中如何使用5+的原生界面控件(包括map、video、livepusher、barcode、nview)

分类:uni-app

uni-app可以调用plus的api操作扩展能力,这块很简单,在app的条件编译里直接写就好了,也不需要plus ready。
但是HTML5 里有很多原生的可视化控件,包括map、video、livepusher、barcode、nview(包括原生头、原生tab),获取这些对象和操作他们需要有特殊写法。
5+app开发时,我们可以用plus.webview.currentWebview获取当前页面,但uni-app里用法不一样,需要这样取当前显示的webview:

const currentWebview = this.$mp.page.$getAppWebview(); //注意相关操作写在APP-PLUS条件编译下

还有一种写法比较冗余,可以获取页面栈中任意一个webview对象:

var pages = getCurrentPages();  
var page = pages[pages.length - 1];  
// #ifdef APP-PLUS  
var currentWebview = page.$getAppWebview(); //页面栈最顶层就是当前webview  
// #endif

注意uni-app不需要像5+App那样等待plus ready,可以直接用。
有了这个currentWebview ,我们就可以做很多事情了,比如:

例子1 创建直播推流

虽然uni-app的nvue页面已经提供了直播组件。但uni-app的vue页面还没有封装,在app里的vue页面使用直播推流就得用这种写法了。(这里指的是推流,如果是拉流,在app侧可直接使用video标签)

var pusher = plus.video.createLivePusher("", {  
    url:'rtmp://testlivesdk.v0.upaiyun.com/live/upyunb',  
    top:'100px',  
    left:'0px',  
    width: '100%',  
    height: '300px',  
    position: 'static'  
});  
currentWebview.append(pusher);

在之前的5+app里,可以使用占位div来布局位置,但在uni-app里,因为没有dom,也没有占位id,所以通过js自己设置原生控件的大小和位置。

例子2 自定义扫码

uni-app的扫码api自带的扫码界面无法有效自定义,大家可以在一个自己的页面里放置一块区域显示扫码控件。

var barcode = plus.barcode.create('barcode', [plus.barcode.QR], {  
    top:'100px',  
    left:'0px',  
    width: '300px',  
    height: '300px',  
    position: 'static'  
});  
//此处未演示扫码成功回调的地址设置,实际请参考HTML5Plus API自行处理  
//注意扫码区域需为正方形,否则影响扫码识别率  
currentWebview.append(barcode);

当然如果使用app-nvue的话,有自带的barcode组件。

例子3 自定义地图

uni-app的原则是vue语法+小程序api。但小程序的api不如plus.map丰富,地图的重度开发者仍然需要plus的map。
uni-app中单独优化了这个地图的获取,通过$getAppMap可直接得到map对象。
然后参考plus.map的api实现更多地图功能。

例子4 给tabbar加个凸起

本例子仅适用于非自定义组件模式
注意tabbar的获取,不是走getCurrentPages,而是用plus.webview.currentWebview()

var centerButtonOnTab = new plus.nativeObj.View("",{top:'500px',left:'160px',height:'50px',width:'50px',backgroundColor:'#FF0000'});  
plus.webview.currentWebview().append(centerButtonOnTab);

这里只是基础演示,大小位置、点击事件,在实际开发中都得自己处理。
插件市场有已经做好的例子:https://ext.dcloud.net.cn/plugin?id=251

如果app端想要高性能的tabbar凸起,建议使用nvue在前端自绘tabbar。

例子5 操作titleNView,给titleNView右上角加个红点

var nTitle = currentWebview.getTitleNView();  
nTitle.drawBitmap("static/reddot.png",{}, {top:'3px',left:'340px',width:'4px',height:'4px'}); //具体尺寸在商用时需自行计算。红点图在附件里。  
//nview的api非常多,具体参考:http://www.html5plus.org/doc/zh_cn/nativeobj.html#plus.nativeObj.View

清除刚才绘制的红点

nTitle.reset();

更新:1.5版的HBuilderX已经支持titleNView的button直接设红点了,hello uni-app的模板里运行到app时也能看到相应示例源码。所以本例子实际作用已经过期,此处纯粹演示用。

5+的plus.nativeObj.view,本质是一种类canvas的画布,可以自由的draw内容上去,更新管理也需要自己维护操作。
包括想在原生控件比如视频、地图上加点什么东西,因为HTML的组件是盖不住原生组件的,都可以使用nview来做。

例子6 uni-app可以在vue页面里写web-view组件,这个组件如何用plus api操作?

vue页面里的web-view 组件其实是一个子webview。
在vue里,通过本文开头的代码,先得到当前页面的webview。
然后调用currentWebview.children()方法来获得所有子webview。
因为执行代码的时机不同,可能执行太早会返回空结果。
如果确定页面里有web-view,则可以再延时一下然后再获取一次children。
这样就能拿到这个子webview。
有了子webview对象后,可以用5+丰富的api来进行前进、后退、拦截资源、禁用schema跳转、注入js等各种操作。具体参考https://www.html5plus.org/doc/zh_cn/webview.html

具体请参考web-view组件的文档

51 关注 分享
清寒 8***@qq.com Trust 诗小柒 v***@163.com x***@sina.com Neil_HL 7***@qq.com 独孤雄鹰 蔡晓亮 4***@qq.com 4***@qq.com Wcheng 9***@qq.com i***@qq.com utopiab 鸿碧青山 b***@126.com j***@139.com ilijiayin 草灯 2***@qq.com skysowe shwanYu m***@163.com 1***@qq.com joelewis k***@gmail.com Smart900zhang sonicsunsky 3***@qq.com 睡着就睡着了 2***@qq.com 2***@qq.com 1***@qq.com l***@126.com Anoxia y***@163.com l***@163.com 漂流瓶 1***@qq.com 迷茫的路人乙 丸崽 2***@qq.com 1***@qq.com 6***@qq.com l***@qq.com 点点0323 小白UNI HRK_01

要回复文章请先登录注册

9***@qq.com

9***@qq.com

var pages = getCurrentPages();
var page = pages[pages.length - 1];
// #ifdef APP-PLUS
var currentWebview = page.$getAppWebview();
// #endif
请问这一段代码应该写在什么地方?原来5+APP是写在plusready方法里面
2018-11-14 11:05
hugo_yu

hugo_yu

回复 DCloud_heavensoft :
好了,唉,我删除那个dev》app-plus两次,才清除掉缓存- -
2018-10-31 10:15
hugo_yu

hugo_yu

回复 DCloud_heavensoft :
地图不支持吗?怎么没个例子,我这新建了也不显示哦
2018-10-31 10:11
独孤雄鹰

独孤雄鹰

Mark
2018-10-24 21:36
DCloud_heavensoft

DCloud_heavensoft (作者)

回复 2***@qq.com :
NView创建的id指定对了,比如你创建一个NView显示小红点,那reset只会把这个nview清了,不会动其他nview
2018-10-08 15:46
2***@qq.com

2***@qq.com

nTabbar.reset(); 这个操作是把tabbar全部清除了,而不是清除红点,我这边测试tabbar一片白了
2018-10-08 13:22
DCloud_heavensoft

DCloud_heavensoft (作者)

回复 Rubik :
http://www.html5plus.org/doc/zh_cn/io.html
2018-09-27 18:04
Rubik

Rubik

回复 DCloud_heavensoft :
你好,还有一个关于原生控件的问题:uniapp从网络下载的文件路径或者持久化的路径用在自带的控件才有效,像原生maps的marker.setIcon或者titleNView的drawBitmap这样如果需要从服务器下载的图片路径的控件怎么传路径才有效?
2018-09-27 15:32
Rubik

Rubik

回复 DCloud_heavensoft :
没有自动改回去,但是打包后还是提示未添加模块。
2018-09-25 17:12
HB_关平

HB_关平

回复 Rubik :
加QQ:804127452
2018-09-25 16:52