第六章[小程序API]总结

6.1网络API

6.1.1发起网络请求

获取HTML数据

.xml

<buttontype="primary"bindtap="getbaidutap">获取数据</button>
<textareavalue='{{html}}'auto-heightmaxlength='0'></textareavalue>

.js

Page({
  data:{
    html:""
  },
  getbaidutap:function(){
    var that = this;
    wx.request({
      url:'https://www.baidu.com',
      data:{},
      header:{'Content-Type':'application/json'},
      success:function(res){
        console.log(res);
        that.setData({
          html:res.data
        })
      }
    })
  }
})

通过wx.request(Object)的GET方法获取邮政编码对应的地址信息

.xml

<view>邮政编码:</view>
<input type="text" bindinput="input" placeholder='6位邮政编码'/>
<button type="primary" bindtap="find">查询</button>
<block wx:for="{{address}}">
    <block wx:for="{{item}}">
        <text>{{item}}</text>
    </block>
</block>

.js

Page({
  data:{
    postcode:"",
    address:[],
    errMsg:"",
    error_code:-1
  },
  input:function(e){
    this.setData({
      postcode:e.detail.value,
    })
    console.log(e.detail.value)
  },
  find:function(){
    var postcode=this.data.postcode;
    if(postcode!=null&&postcode!=""){
      var self=this;
      wx.showToast({
        title:'正在查询, 请稍等......',
        icon:'loading',
        duration:10000
      });
      wx.request({
        url:'https://v.juhe.cn/postcode/query',
        data:{
          'postcode':postcode,
          'key':'0ff9bfccdf147476e067de994eb5496'
        },
        header:{
          'Content-Tppe':'application/json',
        },
        method:'GET',
        success:function(res){
          wx.hideToast();
          if(res.data.error_code==0){
            console.log(res);
            self.setData({
              errMsg:"",
              error_code:res.data.error_code,
              address:res.data.result.list
            })
          }
          else{
            self.setData({
              errMsg:res.data.reason || res.data.reason,
              error_code:res.data.error_code
            })
          }
        }
      })
    }
  }
})

示意图

6.1.2上传文件

 图片上传到服务器并显示示例代码

.xml

<button type="primary" bindtap="uploadimage">上传图片</button>
<image src="{{img}}" mode="widthFix"/>

.js

Page({
  data:{
    img:null,
  },
  uploadimage:function(){
var that=this;
wx.chooseImage({
  success:function(res){
    var tempFilePaths=res.tempFilePaths
    upload(that.tempFilePaths);
  }
})
function upload(page,path){
  wx.showToast({
    icon:"loading",
    title:"正在上传"
  }),
  wx.uploadFile({
    url:"http://localhost/",
    filePath:path[0],
    success:function(res){
      console.log(res);
      if(res.statusCode!=200){
        wx.showModal({
          title:'提示',
          content:'上传失败',
          showCancel:false
        })
        return;
      }
      var data=res.data
      page.setData({
        img:path[0]
      })
    },
    fail:function(e){
      console.log(e);
      wx.showModal({
        title: '提示',
        content: '上传失败',
        showCancel:false
      })
    },
    complete:function(){
      wx.hideToast();
    }
  })
}
  }
})

效果图

6.2多媒体API

6.2.1 图片API

示例代码

1.选择图片或拍照

wx.chooseImage({
count:2,
sizeType:['original','compressed'],
sourceType:['albnm','camera'],
success:function(res){
var tempFilePaths
var tempFiles=res.tempFiiles;
comsole.log(tempFilePaths)
console.log(tempFiles)
}})

2.预览图片

示例代码

wx.previewImage({
current:"http://bmob-cdn-16488.b0.upaiyun.com/2018/02/05/2.png",
urls:[""],
"http://",
"http://......"]})

3.获取图片信息

示例代码

wx.chooseImage({
success:function(res){
wx.getImageInfo({
src:res.tempFilePaths[0],
success:function(e){
console.log(r.width)
comsole.log(e.height)
}
})
},
})

4.保存图片到系统相册

示例代码

wx.chooseImage({
success:function(res){
wx.saveImageToPhotosAlbum({
filePath:res.tempFilePaths[0],
success:function.log(e)
}
})
},
})

6.2.2录音API

1.开始录音

wx.startRecord接口用于开始录音

2.停止录音

wx.stopRecord接口用于实现主动调用停止录音 

示例代码

wx.startRecord)
({
success:function(res){
var tempFilePath=res.tempFilePath
},
fail:function(res){
}
})
setTimeout(function(){
wx.stopRecord()},10000)

6.2.3 音频播放控制API 

1.播放语音

wx.playVoice接口用于开始播放语言,同时只允许一个语言文件播放,其参数如下

示例代码如下

wx.startRecord({
success:function(res){
var tempFilePath=res.tempFilePath
wx.playVoice({
filePath:tempFilePath,
complete:function(){}
}
})
}
})

2.暂停播放

wx.pauseVoice用于暂停正在播放的录音.再次调用wx.playVoice播放同一个文件时,会从暂停处开始播放.如果想从头开始播放,则需要先调用wx.stopVoice.

示例代码如下:

wx.startReacord({
success:function(res){
var tempFilePath=res.tempFilePath
wx.playVoice({
filePath:tempFilePath})
setTimeout(function(){
wx.pauseVoice()},5000)}})

6.2.4 音乐控制API

案例代码

.xml

<view class="container">
<image class="bgaudio" src="{{changedImg? music.cooverImg:'/image/background.png'}}"></image>
<view class="countrol-view">
<image src="/image/pre.png" bindtap="onPositionTap" data-how="0"></image>
<image src="/image/{{isPlaying? 'pause':'play'}}.png" bindtap="onAudioTap"></image>
<image src="/image/stop.png" bindtap="onStopTap"></image>
<image src="/image/next.png" bindtap="onPositionTap" data-how="1"></image></view></view>

.js

Page({
  data:{
    isPlaying:false,
    coverImg
    changedImg:false,
    music:{
      "url":"http://bmob-cdn-16488.b0.upaiyun.com/2018/02/09/117e4a1b405195b18061299e2de89597.mp3",
      "title":"盛放-uoy",
      "coverImg":"http://bmob-cdn-16488.b0.upaiyun.com/2018/02/09/f604297140c9681880cc3d3e581f7724.jpg"
    },
  },
  onLoad:function(){
    this.onAudioState();
  },
  onAudioTap:function(event){
    if(this.data.isPlaying){
      wx.pauseBackgroundAudio();
    }else{
      let music=this.data.music;
      wx.playBackgroundAudio({
        dataUrl:music.url,
        title:music.title,
        coverImgUrl:music.coverImg
      })
    }
  },
  onStopTap:function(){
    let that = this;
    wx.stopBackgroundAudio({
      success:function(){
        that.setData({
          isPlaying:false,changedImg:false
        });
      }
    })
  },
  onPositionTap:function(event){
    let how=weent.target.dataset.how;
    wx.getBackgroundAutioPlayerState({
      success:function(res){
        let status=res.status;
        if(status===1){
          let duration=res.duration;
          let currentPosition=res.currentPosition;
          if(how==="0"){
            let position=currentPosition-10;
            if(position<0){
              position=1;

            }
            wx.seekBackgroundAudio({
              position:position
            });
            wx.showToast({title:"快退",durat:500});
          }
          if(how==="1"){
            let position=currentPosition+10;
            if(position>duration){
              position=duration -1;
            }
            wx.seekBackgroundAudio({
              position: position
            });
            wx.showToast({
              title: '快进十秒',durration:500
            })
            
          }
        }else{
          wx.showToast({
            title: '音乐未播放',durration:800
          });
        }
      }
    })
  },
  onAudioState:Function(){
    let that=this;
    wx.onBackgroundAudioPlay(funcation(){
      that.setData({isPlaying:true,changedImg:true});
      console.log("on play");
    });
    wx.onBackgroundAudioPause(function(){
      that.setData({isPlaying:false});
      console.log("on pause");

    });
    that.setData({isPlaying:false,changedImg:false});
    console.log("on stop");
  }
})

6.3 文件API

1.保存文件

部分示例代码

saveImg:function(){
wx.chooseImage({
count:1,
sizeType:['original','compressed'].
sourceType:['album','camera'],
successs:function:function(res){
var tempFilePaaths=res.tempFilePAaths[0]
wx.saveFile({
tempFilePAths:tempFilePaths,
success:fun ction:function(res){
var saveFilePath=res.savedfILEpATHS;
CONSOLE.LOG(SAVEfILEpATHS)
}
})
}
})
}

2.获取本地文件列表

示例代码如下

wx.getSavedFileLIST({
SUCCESS:FUNCTION(RES){
THST.SETdata({
fileList:res,fileList})
}}
)}

3.获取本地文件的文件信息

示例代码如下

wx.chooseImage({
count:1,
sizeGType:['original','coompressed'],
sourceType:['album','camera'].
success:function(res){
var tempFilePaths[0]
wx.saveFlie({
tempFilePaths,
success:function(res){
var saveFilePaths=res.saveedFilePath;
wx.getSavedFileInfo({
filePath:saveFilePath,
success:function(res){
console,log(res,size)
}
})
})
}
})

4.删除本地文件

wx.removeSaveFile接口用于删除本地存储的文件,其相关参数如图

从文件列表中删除第一个文件,示例代码如下 

wx.getSavedFileList({
success:functiojn(res){
if(res.fileList.length>0){
微信.removeSavedFile({
filePath:res.fileList[0].filePath,
complete:function(res){
console.log(res)
}
})
}
}
})

5.打开文档

wx.openDocument接口用于新开页面打开文档

示例代码如下

wx.downLoadFile({
url:"http://localhost/fm2.pdf",
success:function(res){
var tempFilePath=res.tempFilePaath;
wx.openDocument({
filePath:tempFilePATH,
SUCCESS:FUNCTION(RES){
CONSOLE.LOG("打开成功")
}
})
}
})

6.4本地数据及缓存API

6.4.1 保存数据

1.wx.setStorage

wx.setStorage接口将数据存储到本地缓存接口的指定key中,接口执行后会覆盖原来key对应的内容.其参数如下所示

示例代码如下

wx.setStorage({
key:'name',
data:'sdy',
success:function(res){
console.log(res)}
})

2.wx.setStoragSyne(key,data)

wx.setStorageSync(key,data)是同步接口,其参数只有key和data

示例代码如下

wx.setStorageSync('age','25')

6.4.2 获取数据

1.wx.getStorage

wx.getStorage接口是从本地缓存中异步获取指定的key对应的内容,其相关参数如下

示例代码如下

wx.getStorage({
key:'name',
success:function(res){
console.log(res.data)
},
})

2.wx.getStorageSync(key)

wx.getStorageSync从本地缓存中同步获取指定key对应的内容,其参数只有key

示例代码如下

try{
var value=wx.getStorageSync('age')
if(value){
console.log("获取成功"+value)
}
}catch(e){
console.log("获取失败")
}

6.4.3 删除数据

1.wx.removeStorage

wx.removeStorage接口用于从本地缓存中异步移除指定key,其相关参数如图

示例代码如下

wx.removeStorage({
key:'name',
success:function(res){
console.log("删除成功")
},
fail:function(){
console.log("删除失败")
}
})

2.wx.removeStorageSync

wx.removeSync接口用于从本地缓存中同步删除指定key对应的内容,其参数只有key

示例代码如下

try{
wx.removeStorageSync('name')
} catch(e){
}

6.4.4清空数据

1.wx.clearStorage()

wx.clearStorage()接口用于异步清理本地缓存数据,没有参数

示例代码如下

wx.getStorage({
key:'name',
success:function(res){
wx.clearStorage()
},
})

2.wx.clearStroageSync()

用于同步清理本地数据缓存

示例代码如下

try{
wx.clearStoroageSync()
} catch(e){
}

6.5 位置信息API

6.5.1 获取位置信息

wx.getLocation接口用于获取当前用户的地理位置`速度,需要用户开启定位功能,当用户离开小程序后,无法获取当前位置的地理位置及速度,当用户点击"显示在聊天顶部"时,可以获取到定位信息,其参数如下

wx.getLocation调用成功后,返回的参数如下所示

示例代码如下

.js 

wx.getLocation({
type:'wgs85',
success:function(res){
console.log("经度:"+res.longitude);
console.log("纬度:"+res.latitude);
},
})

.xml

<view class="container">
  <view class="button-container">
    <button bindtap="getLocation">获取地理位置信息</button>
  </view>
</view>

效果图

6.5.2 选择位置信息

wx.chooseLocation接口用于在打开的地图中选择位置,用户选择位置后可返回当前位置的名称`地址`经纬度信息,其相关参数如图所示

wx.chooseLocation调用成功后,返回的参数如图所示

示例代码如下

.js

Page({
  data: {
    markers: [],
    polyline: [],
    controls: []
  },
  onLoad: function () {
    // 在页面加载时调用chooseLocation接口
    wx.chooseLocation({
      success: function (res) {
        console.log(res);
        // 更新data中的markers信息，添加选择的位置
        var newMarkers = [{
          iconPath: "../image/选择位置.png",
          id: 0,
          longitude: res.longitude,
          latitude: res.latitude,
          width: 50,
          height: 50
        }];
        this.setData({
          markers: newMarkers
        });
      }.bind(this) // 注意这里使用bind(this)，以便在回调函数中使用setData更新data
    });
  },
  regionchange: function (e) {
    console.log(e.type);
  },
  markertap: function (e) {
    console.log(e.markerId);
  },
  controltap: function (e) {
    console.log(e.controlId);
  }
});

.xml

<map id="map"
longitude="108.9200"
latitude="34.1550"
scale="14"
controls="{{controls}}"
bindcontroltap="controltap"
markers="{{markers}}"
bindmarkertap="markertap"
polyline="{{polyline}}"
bindregionchange="regionchange"
show-location
style="width: 100%;height: 300px;"></map>

效果图

6.5.3 显示位置信息

wx.openLocation接口用于在微信内置地图中显示位置信息,其相关参数如表

示例代码如下

.js 

Page({
  data: {
    locationInfo: {} // 存储位置信息
  },
  onLoad: function () {
    wx.getLocation({
      type:'gcj02',
      success:function(res){
      var latitiud=res.latitiud
      var longitude=res.longitude
      wx.openLocation({
      latitude:latitude,
      longitude:longitude,
      scale:10,
      name:'智慧国际酒店',
      address:'西安市长安区300号'
      })
      }
      })
    // 在页面加载时调用chooseLocation接口
    wx.chooseLocation({
      success: function (res) {
        console.log(res);
        // 存储位置信息
        this.setData({
          locationInfo: res
        });
        // 打开地图显示位置信息
        wx.openLocation({
          latitude: res.latitude,
          longitude: res.longitude,
          name: res.name,
          address: res.address
        });
      }.bind(this) // 注意这里使用bind(this)，以便在回调函数中使用setData更新data
    });
  },
  regionchange: function (e) {
    // 处理地图区域变化事件
    console.log(e.type);
  },
  markertap: function (e) {
    // 处理点击标记点事件
    console.log(e.markerId);
  },
  controltap: function (e) {
    // 处理点击控件事件
    console.log(e.controlId);
  }
});

.xml

<map id="map" longitude="108.9200" latitude="34.1550" scale="14" controls="{{controls}}" bindcontroltap="controltap" markers="{{markers}}" bindmarkertap="markertap" polyline="{{polyline}}" bindregionchange="regionchange" show-location style="width: 100%; height: 300px;"></map>

6.6  设备相关API

6.6.1 获取系统信息

wx.getSystemInfo接口,wx.getSystemInfoSync接口分别用于异步和同步系统获取系统信息,其相关参数如下

wx.getSystemIfon接口或wx.SystemInfo接口调用成功后,返回系统相关信息,如表所示

 

示例代码如下

.js 

Page({
  onLoad: function () {
    wx.getSystemInfo({
      success: function (res) {
        console.log("手机型号:" + res.model)
        console.log("设备像素比:" + res.pixelRatio)
        console.log("窗口的宽度:" + res.windowWidth)
        console.log("窗口的高度:" + res.windowHeight)
        console.log("微信的版本号:" + res.version)
        console.log("操作系统版本:" + res.system)
        console.log("客户端平台:" + res.platform)
      }
    })
  }
})

效果图

6.6.2 网络状态

1.获取网络状态

wx. getNetworkType用于获取网络类型,其相关参数如表所示

 

如果接口调用成功,则返回网络类型

示例代码如下

wx.getNetworkType({
success:function(res){
console.log(res.networkType)
},
})

2.获取网络状态变化

wx.onNetworkStatusChange(CallBack)接口用于监听网络状态变化,当网络状态变化时.返回当前网络状态类型及是否有网络连接

示例代码如下

wx.onNetworkStatusChange(function(res){
console.log("网络是否连接:"+res.isConnected)
console.log("变化后的网络类型:"+res.networkType)
})

6.6.3 拨打电话

wx.makePloneCall接口用于实现调用手机拨打电话,其相关参数如下

 

示例代码

wx.makePhoneCall({
phoneNumber:'1341422234"
})

6.6.4 扫描二维码

wx.scanCode接口用于调取客户端扫码界面,扫码成功后返回相应的内容,其相关参数如下

 

扫码成功后,返回的数据如表所示

 

示例代码如下

wx.scanCode({
success:(res)=>{
console.log(res.result)
console.log(res.scanType)
console.log(res.charSet)
console.log(res.path)
}
})
wx.scanCode({
onlyFromCamera:true,
success:(res)=>{
console.log(res)
}
})