效果图
卡片效果如下:
关键技术及实现原理
卡片现有支持的底子组件有:button、calendar、chart、clock、divider、image、input、progress、span、text。
可以看到现有的卡片组件并不支持地图的开辟,那么如何在卡片上显示地图尼?
通过 image 组件+高德地图 WebAPI 的静态地图即可实现地图的显示。
以上方便有开辟卡片履历的开辟者提供思绪,具体方式方法如下:
从零开始
①创建项目
打开 DevEco Studio 工具,点击 File->New->New Project 创建一个 Empty Ability(JS),如下图,SDK 选用了 API 5。
新建
参数调解
创建后的结构:
起首修改步伐的设置文件,打开 config.json,修改卡片支持类型环境:
添加权限:
设置完成还需要在 MainAbility 中显示的说明使用权限信息,详情参考文档设置相关内容。
打开 MainAbility 添加方法,并在 onStart 方法中调用 requestPermission();方法:
- //获取权限
- private void requestPermission() {
- String[] permission = {
- "ohos.permission.LOCATION",
- "ohos.permission.LOCATION_IN_BACKGROUND",
- };
- List<String> applyPermissions = new ArrayList<>();
- for (String element : permission) {
- if (verifySelfPermission(element) != 0) {
- if (canRequestPermission(element)) {
- applyPermissions.add(element);
- }
- }
- }
- requestPermissionsFromUser(applyPermissions.toArray(new String[0]), 0);
- }
复制代码 ②修改界面
打开 widget 下的 pages/index/imdex.hml:
- <div class="container">
- <div class="container-inner" >
- <div class="container-img">
- <stack>
- <image src="{{imgSrc}}" class="bg-img"></image>
- <div class="container-show-text" >
- <text class="show-text" >当前检索项:</text>
- <text class="show-text" style="color: coral;" >{{searchText}}</text>
- </div>
- <div class="container-map-ctl">
- <button class="map-ctl-btn" @click="mapAddEvent" type="circle">+</button>
- <button class="map-ctl-btn" @click="mapReduceEvent" type="circle">-</button>
- </div>
- <div show="{{showCtlButton}}" class="container-ctl" >
- <button class="ctl-btn" @click="searchCheckedEvent0">{{searchBtns[0]}}</button>
- <button class="ctl-btn" @click="searchCheckedEvent1">{{searchBtns[1]}}</button>
- <button class="ctl-btn" @click="searchCheckedEvent2">{{searchBtns[2]}}</button>
- <button class="ctl-btn" @click="searchCheckedEvent3">{{searchBtns[3]}}</button>
- <button class="ctl-btn" @click="searchCheckedEvent4">{{searchBtns[4]}}</button>
- </div>
- </stack>
- </div>
- </div>
- </div>
复制代码 需要注意:卡片的事件不能使用表达式,不能使用 for 语句循环构建。
样式调解文件 pages/index/imdex.css:
- .container {
- flex-direction: column;
- justify-content: center;
- align-items: center;
- }
- .bg-img {
- flex-shrink: 0;
- height: 100%;
- object-fit: cover;
- }
- .container-ctl{
- opacity: 0.9;
- width: 100%;
- height: 100%;
- justify-content: center;
- flex-direction: row;
- align-items: flex-end;
- bottom: 3px;
- }
- .ctl-btn{
- padding: 3px 6px;
- margin:3px 6px;
- font-size: 12px;
- border-radius: 3px;
- background-color: #409eff;
- border: 1px solid #cbcbcb;
- box-shadow: 1px 1px 3px #a8a8a8;
- }
- .container-map-ctl{
- opacity: 0.8;
- justify-content: flex-end;
- margin-right: 3px;
- }
- .map-ctl-btn{
- background-color: #409eff;
- border: 1px solid #cbcbcb;
- box-shadow: 1px 1px 3px #a8a8a8;
- width: 24px;
- height: 24px;
- margin:3px;
- }
- .container-show-text{
- padding: 9px;
- }
- .show-text{
- font-size: 8px;
- font-weight: bolder;
- }
复制代码 json 设置信息修改 pages/index/index.json:
- {
- "data": {
- "showCtlButton": false,//是否显示button。由Java传值且在2x2的界面不显示
- "imgSrc": "/common/ic_default_image@3x.png",//默认图片
- "searchText": "",
- "searchBtns": []//配置的button按钮信息
- },
- "actions": {
- "searchCheckedEvent0": {
- "action": "message",
- "params": {
- "index": 0,
- "name": "checkSearch"
- }
- },
- "searchCheckedEvent1": {
- "action": "message",
- "params": {
- "index": 1,
- "name": "checkSearch"
- }
- },
- "searchCheckedEvent2": {
- "action": "message",
- "params": {
- "index": 2,
- "name": "checkSearch"
- }
- },
- "searchCheckedEvent3": {
- "action": "message",
- "params": {
- "index": 3,
- "name": "checkSearch"
- }
- },
- "searchCheckedEvent4": {
- "action": "message",
- "params": {
- "index": 4,
- "name": "checkSearch"
- }
- },
- "mapAddEvent": {
- "action": "message",
- "params": {
- "name": "mapAdd"
- }
- },
- "mapReduceEvent": {
- "action": "message",
- "params": {
- "name": "mapReduce"
- }
- }
- }
- }
复制代码 后台逻辑
由于更新卡片时需要提供 formId,我们对 FormController 及 FormControllerManager 这两个帮助类举行一个修改。
打开 java 目录下的 FormController 文件并添加受保护的属性 formId,并修改构造函数。
然后进入 FormControllerManager 找到 createFormController、getController、newInstance 举行修改。
①createFormController
在 newInstance 方法中添加参数 formId,如下图:
②getController
在 newInstance 方法中添加参数 formId,如下图:
③newInstace
该方法是动态的创建 WidgetImpl 方法,类似于 IOC 作用:

找到 java 目录下的 widget/widget/widgetImpl,卡片的全部逻辑都在该文件内。
起首修改构造函数及定义底子属性等,因上述修改了 FormController 及 FormControllerManager 构造函数必须增加 Long formId 参数。
- private static Location slocation=null;//当前位置信息
- private Boolean slocationChanged=false;//位置是否修改
- private int dimension=2;//当前卡片模式 2x2=2;2x4=3;4x4=4;
- private List<String> defualtBtn=new ArrayList<>();//界面下方的按钮列表
- private static Locator locator=null;//坐标获取类
- private LocatorCallBack locatorCallBack=new LocatorCallBack();//坐标获取后返回调用类
- private int mRoom=16;//静态地图显示层级
- private String markType="";//静态地图周边搜索关键字
- private String mSize="500*500";//静态地图大小
- private List<String> mKeyLocation=new ArrayList<>();//静态地图获取周边标记的坐标
- RequestParam requestParam = new RequestParam(RequestParam.PRIORITY_ACCURACY, 20, 0);
- public WidgetImpl(Context context, String formName, Integer dimension,Long formId) {
- super(context, formName, dimension,formId);
- this.dimension=dimension;
- //获取当前定位
- if(locator==null){
- locator=new Locator(context);
- locator.startLocating(requestParam,locatorCallBack);
- }
- switch (dimension){
- case 2:{
- mSize="300*300";
- mRoom=13;
- break;
- }
- case 3:{
- mSize="500*250";
- mRoom=13;
- break;
- }
- case 4:{
- mSize="500*500";
- mRoom=15;
- break;
- }
- }
- }
- public class LocatorCallBack implements LocatorCallback{
- @Override
- public void onLocationReport(Location location) {
- slocation=location;
- //周边信息接口额度有限,限制为当坐标改变时刷新坐标mark信息,并更新卡片
- if(location==slocation || slocation==null)
- return;
- refreshMark();
- updateFormData(formId);
- }
- @Override
- public void onStatusChanged(int i) {
- }
- @Override
- public void onErrorReport(int i) {
- }
- }
复制代码 修改 createFormController,该方法在卡片创建时调用,我们需要把页面需要的参数传递已往。
注意网络图片需要使用“通过内存图片方式使用 image 组件。
- @Override
- public ProviderFormInfo bindFormData(){
- defualtBtn=new ArrayList<>();
- defualtBtn.add("酒店");
- defualtBtn.add("餐饮");
- defualtBtn.add("景点");
- defualtBtn.add("加油站");
- if(defualtBtn.size()<5){
- for(int i=defualtBtn.size();i<5;i++){
- defualtBtn.add("未设置");
- }
- }
- this.markType=defualtBtn.get(0);
- this.refreshMark();
- FormBindingData formBindingData=null;
- ZSONObject zsonObject =new ZSONObject();
- zsonObject.put("imgSrc","memory://amap.png");
- zsonObject.put("showCtlButton",this.dimension!=2);
- zsonObject.put("searchBtns",defualtBtn);
- zsonObject.put("searchText",markType);
- formBindingData=new FormBindingData(zsonObject);
- ProviderFormInfo formInfo = new ProviderFormInfo();
- formInfo.setJsBindingData(formBindingData);
- String amapUrl=getMapImageUrl(mKeyLocation);
- byte[] bytes= HttpImageUtils.doGetRequestForFile(amapUrl);
- formBindingData.addImageData("amap.png",bytes);
- return formInfo;
- }
复制代码 初始化卡片后改进 onTriggerFormEvent,该方法为接收卡片事件,message 为事件传递的 params 参数。
- @Override
- public void onTriggerFormEvent(long formId, String message) {
- ZSONObject request=ZSONObject.stringToZSON(message);
- String EventName=request.getString("name");
- switch (EventName){
- case "checkSearch":{
- int index=request.getIntValue("index");
- markType=defualtBtn.get(index);
- this.refreshMark();
- break;
- }
- case "mapAdd":{
- if(mRoom<17){
- mRoom+=1;
- }
- break;
- }
- case "mapReduce":{
- if(mRoom>0){
- mRoom-=1;
- }
- break;
- }
- }
- updateFormData(formId);
- }
复制代码 修改更新卡片信息的方法,此方法不仅是体系会定时刷新,也有主动刷新的调用如:卡片事件改变后调用,坐标改变后的调用。
这也是需要修改 FormController、FormControllerManager 增加 formId 属性的缘故起因,因为在主动刷新时需要 formId 参数。
此处另有一个重点就是:
- ((Ability)context).updateForm(formId,bindingData);
复制代码- @Override public void updateFormData(long formId, Object... vars) { ZSONObject zsonObject=new ZSONObject(); zsonObject.put("searchBtns",defualtBtn); zsonObject.put("searchText",markType); String mapName="amap"+System.currentTimeMillis()+".png"; zsonObject.put("imgSrc","memory://"+mapName); FormBindingData bindingData = new FormBindingData(zsonObject); String amapUrl=getMapImageUrl(mKeyLocation); byte[] bytes= HttpImageUtils.doGetRequestForFile(amapUrl); bindingData.addImageData(mapName,bytes); try{ ((Ability)context).updateForm(formId,bindingData);
- }catch (Exception ex){ ex.printStackTrace(); } }
复制代码 其他一些上述方法中调用的私有方法及类。
私有方法:
- private void refreshMark(){
- try{
- this.mKeyLocation= HttpImageUtils.SearchByKeyUrl(getMapMarkUrl(10));
- }catch (Exception ex){
- ex.printStackTrace();
- }
- }
- private String getMapImageUrl(List<String> Position){
- String url="https://restapi.amap.com/v3/staticmap";
- String params="key=";
- params+="&zoom="+mRoom;
- params+="&size="+mSize;
- if(slocation!=null)
- params+="&location="+slocation.getLongitude()+","+slocation.getLatitude();
- params+="&markers=large,0xea7700,H:"+slocation.getLongitude()+","+slocation.getLatitude();
- if(Position==null || Position.size()==0)
- return url+"?"+params;
- String markers="|mid,0xFF0000,:";
- for(int i=0;i<Position.size();i++){
- markers+=Position.get(i)+";";
- }
- params+=markers.substring(0,markers.length()-1);
- return url+"?"+params;
- }
- private String getMapMarkUrl(int size){
- String Url="https://restapi.amap.com/v5/place/around?key=";
- Url+="&keywords="+(markType=="未设置"?"":markType);
- if(slocation!=null)
- Url+="&location="+slocation.getLongitude()+","+slocation.getLatitude();
- Url+="&size="+size;
- return Url;
- }
复制代码 HttpImageUtils 类:
至此一个地图周边的卡片即可开辟完成
最后
有许多小伙伴不知道学习哪些鸿蒙开辟技术?不知道需要重点掌握哪些鸿蒙应用开辟知识点?但是又不知道从那里动手,而且学习时频仍踩坑,最终浪费大量时间。所以本人整理了一些比力合适的鸿蒙(HarmonyOS NEXT)学习路径和一些资料的整理供小伙伴学习
点击领取→纯血鸿蒙Next全套最新学习资料希望这一份鸿蒙学习资料可以大概给大家带来帮助,有需要的小伙伴自行领取~~
一、鸿蒙(HarmonyOS NEXT)最新学习蹊径
有了蹊径图,怎么能没有学习资料呢,小编也预备了一份团结鸿蒙官方发布条记整理收纳的一套体系性的鸿蒙(OpenHarmony )学习手册(共计1236页)与鸿蒙(OpenHarmony )开辟入门讲授视频,内容包含:(ArkTS、ArkUI开辟组件、Stage模子、多端部署、分布式应用开辟、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开辟、鸿蒙项目实战等等)鸿蒙(HarmonyOS NEXT)…等技术知识点。
获取以上完备版高清,请点击→纯血版全套鸿蒙HarmonyOS学习资料
二、HarmonyOS Next 最新全套视频教程
三、《鸿蒙 (OpenHarmony)开辟底子到实战手册》
OpenHarmony北向、南向开辟环境搭建
四、大厂面试必问面试题
五、鸿蒙南向开辟技术
六、鸿蒙APP开辟必备
完备鸿蒙HarmonyOS学习资料,请点击→纯血版全套鸿蒙HarmonyOS学习资料
总结
总的来说,对于大家来说ye是一个挑衅,也是一个机会。只有积极应对变化,不绝学习和提升本身,他们才气在这个厘革的时代中立于不败之地。
免责声明:如果侵犯了您的权益,请联系站长,我们会及时删除侵权内容,谢谢合作!更多信息从访问主页:qidao123.com:ToB企服之家,中国第一个企服评测及商务社交产业平台。 |