2021-08-20 小程序拍照和裁剪功能实现

拍照：一般小程序中会自定义拍照界面，可通过camera组件实现，可通过device-position属性动态控制前后摄像头，使用相机需用户授权（微信官方文档：https://developers.weixin.qq.com/miniprogram/dev/component/camera.html）。

页面搭建如下：

<view class="container">
    <!-- 捕捉画面（拍摄）区域：给定组件宽和高，拍出来的照片的宽高就是这个值 -->
    <camera wx:if="{{isAuthCamera}}" device-position="{{isFront}}" style="width: 100%; height: 70vh;"></camera>
    <!-- 自定义界面：如下图，可以自己在拍摄区域做些设计 -->
    <view class="photo-wrapper" style='padding-top: {{navHeight}}px;'>
        
    </view>
    <!-- 操作拍照区域：基本的拍照按钮、打开本地相册、切换摄像头方向按钮 -->
    <view class="bottom-wrapper" hidden="{{!cameraIsReady}}">
        <view class="take-area">
            <!--打开相册按钮-->
            <image class="img-icon_photo" src="{{imgModel.icon_photo}}" bindtap="handleOpenAlbum" />
            <!--拍照按钮-->
            <image class="img-icon_photo_btn" src="{{imgModel.icon_photo_btn}}" bindtap="handleTakePhoto" />
            <!--切换摄像头按钮-->
            <image class="img-icon_camera" src="{{imgModel.icon_camera}}" bindtap="handleChangeFront" />
        </view>
    </view>
</view>

<!-- 裁剪照片区域：引入的模板是裁剪插件we-cropper.wxml，可在网上下载 -->
<import src="../we-cropper/we-cropper.wxml" />
<view class="cropper-wrapper" hidden="{{!isTaking}}">
    <template is="we-cropper" data="{{...cropperOpt}}"/>
    <view class="cropper-buttons">
        <view class="cancel" bindtap="handleCloseCropper">取消</view>
        <view class="getCropperImage" bindtap="getCropperImage">确定</view>
    </view>
</view>

40a551346f49910a0370a1ab2d07241d.jpg

点击打开相册：

handleOpenAlbum() {
        const self = this;
        wx.chooseImage({
            count: 1,
            sizeType: ['original', 'compressed'], // 可以指定是原图还是压缩图，默认二者都有
            sourceType: ['album', 'camera'], // 可以指定来源是相册还是相机，默认二者都有
            success(res) {
                self.setData({ isTaking: true });
                self.data.cropperOpt.src = res.tempFilePaths[0];// 裁剪数据赋值
                self.createCropper(self.data.cropperOpt);// 实例化WeCropper
            }
        })
    },

相机获取用户授权后，通过官方提供的wx.createCameraContext()创建 camera上下文对象，调用takePhoto()方法实现拍摄：

handleTakePhoto() {
        const self = this;
        mainService.throttle(() => {// 防抖
            wx.createCameraContext().takePhoto({
                quality: "normal",
                success: (res) => {
                    self.setData({ isTaking: true });
                    self.data.cropperOpt.src = res.tempImagePath;// 裁剪数据赋值
                    self.createCropper(self.data.cropperOpt);// 实例化WeCropper
                },
                fail: (err) => {
                    console.log(err, 'fail')
                }
            })
        }, 2000);
    },

切换摄像头，只需修改camera的device-position属性值即可：

handleChangeFront() {
        this.setData({ isFront: this.data.isFront == 'front' ? 'back' : 'front' });
    },

裁剪：页面中引入并调用下载的插件模板WeCropper后，样式需要注意一下，可自行设计样式，这里我添加了2个操作按钮：

.cropper-wrapper{
    position: fixed;
    top: 0;
    left: 0;
    z-index:100000 ;
    width: 100vw;
    height: 100vh;
    .cropper-buttons{
        position: absolute;
        left: 0;
        bottom: 0;
        width: 100%;
        height: 100px;
        background-color: rgba(0, 0, 0, 0.8);
        display: flex;
        justify-content: center;
        .cancel,.getCropperImage{
            width: 200rpx;
            height: 40px;
            border-radius: 20px;
            background-image: linear-gradient(#A2B2EB,#697AD3);
            text-align: center;
            line-height: 40px;
            color: #fff;
        }
        .cancel{
            background:#fff;
            color:#000;
            margin-right: 30rpx;
        }
    }
}

55601c0131787bef182fb2df4eedbc6e.jpg

从wxml代码中可以看到WeCropper的使用是需要给它传一些数据的，这些数据就是实例化WeCropper用的，话不多说上代码：

import WeCropper from '../we-cropper/we-cropper.js'；// 页面中引入插件js文件 
const device = wx.getSystemInfoSync(); // 获取设备信息
const width = device.windowWidth; // 获取设备宽，方便设置画布和裁剪框宽度
const height = device.windowHeight; // 获取设备高，方便设置画布和裁剪框高度

        // Page.data中准备以下初始数据
        cropperOpt: {
            id: 'cropper', // 用于手势操作的canvas组件标识符
            targetId: 'targetCropper', // 用于用于生成截图的canvas组件标识符
            pixelRatio: device.pixelRatio, // 传入设备像素比
            width,  // 画布宽度
            height:height-100, // 画布高度
            scale: 2.5, // 最大缩放倍数
            zoom: 8, // 缩放系数
            cut: {
                x: (width - 355) / 2, // 裁剪框x轴起点
                y: (height - 355) / 2, // 裁剪框y轴期起点
                width: 355, // 裁剪框宽度
                height: 355 // 裁剪框高度
            }
        },

以上数据具体可以参考官方的说明（官方文档url我忘记了，自行搜索下子吧），值得注意的是：
1、实例化还需要图片路径数据，但图片路径是在我们拍照完后才有的，所以在打开相册选择照片后或者点击拍照后将图片路径赋给data.cropperOpt.src属性；
2、data.cropperOpt.cut的数据是可以根据业务需要随时调整的，这里我提前封装了实例化函数，在具体业务处（比如打开相册和点击拍照的地方）修改完数据后再调用此函数；

    // 实例化WeCropper，参数就是完成上述1、2之后的data.cropperOpt
    createCropper(cropperOpt) {
        this.cropper = new WeCropper(cropperOpt)
            .on('ready', (ctx) => {
            })
            .on('beforeImageLoad', (ctx) => {
                wx.showToast({
                    title: '上传中',
                    icon: 'loading',
                    duration: 20000
                })
            })
            .on('imageLoad', (ctx) => {
                wx.hideToast()
            })
    },

实例化完成，就可以开始进行照片裁剪，通过this.cropper.getCropperImage()获取裁剪后的图片路径：

    //裁剪插件触发
    touchStart(e) {
        this.cropper.touchStart(e)
    },
    touchMove(e) {
        this.cropper.touchMove(e)
    },
    touchEnd(e) {
        this.cropper.touchEnd(e)
    },
    //点击确认裁剪图片
    getCropperImage() {
        mainService.throttle(()=>{// 按钮防抖
            this.cropper.getCropperImage().then(tempFilePath =>{
                if (tempFilePath) {
                    // tempFilePath 为裁剪后的图片临时路径
                    // 这里实现业务逻辑...             
                } else {
                    mainService.toast('获取图片地址失败，请稍后重试');
                }
            })
        },1000)
    },
    //点击取消裁剪
    handleCloseCropper() {
        this.setData({ isTaking: false });
    },

至此，微信小程序拍照和裁剪功能实现完毕。