Flutter 相机拍照并上传到服务器

田螺收纳 app 需要拍摄衣物图片并上传服务器,研究了一波 Flutter 操作相机的细节,本文为实践笔记。

引入第三方库

编辑 pubspec.yaml 文件,添加第三库:

dependencies:
    camera:
    path_provider:
    path:
  • camera 获取手机上的相机,返回值是个数组,手机一般自带一个相机,还可以下载第三方相机如美颜相机等;
  • path_provider 提供路徑來儲存照片;
  • path 建立一個可以在使用任何裝置的路徑。

实现拍照功能

想一想我们如何使用 app 进行拍照,我们通常会点击拍照按钮,之后会跳转到一个拍照的页面。

编写拍照页面

如下是一个普通的拍照页面,你可以直接将它复制到您的项目中,也可以在阅读此页面源码后进行局部定制。

拍照页面接收两个参数:

  • camera 您需要给拍照页面传递一个相机。如前文所述,一台手机上可能会有多个可使用的相机(手机自带相机、从应用商店下载的美颜相机);
  • onOk 当您点击确认拍照时,在这个方法里编写需要做哪些事,如将拍照的图片上传到服务器或直接预览图片等。
import 'dart:io';

import 'package:camera/camera.dart';
import 'package:flutter/material.dart';
import 'package:path/path.dart';
import 'package:path_provider/path_provider.dart';

class TakePictureScreen extends StatefulWidget {
  final CameraDescription camera;
  final Function onOk;

  const TakePictureScreen({
    Key key,
    @required this.camera,
    @required this.onOk,
  }) : super(key: key);

  @override
  TakePictureScreenState createState() => TakePictureScreenState();
}

class TakePictureScreenState extends State<TakePictureScreen> {
  CameraController _controller;
  Future<void> _initializeControllerFuture;
  String _imagePath;

  @override
  void initState() {
    super.initState();
    _controller = CameraController(
      widget.camera,
      ResolutionPreset.medium,
    );

    _initializeControllerFuture = _controller.initialize();
  }

  @override
  void dispose() {
    _controller.dispose();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    if (_imagePath != null) {
      return Scaffold(
        body: Stack(
          fit: StackFit.expand,
          children: [
            Image.file(File(_imagePath)),
            Positioned(
              bottom: 20.0,
              left: 20.0,
              child: Container(
                decoration: new BoxDecoration(
                  border:
                      new Border.all(color: Colors.grey, width: 0.5), // 边色与边宽度
                  color: Colors.white, // 底色
                  shape: BoxShape.circle, // 圆形,使用圆形时不可以使用borderRadius
                ),
                alignment: Alignment.center,
                child: IconButton(
                  icon: Icon(Icons.replay),
                  onPressed: () {
                    setState(() {
                      _imagePath = null;
                    });
                  },
                ),
              ),
            ),
            Positioned(
              bottom: 20.0,
              right: 20.0,
              child: Container(
                decoration: new BoxDecoration(
                  border:
                      new Border.all(color: Colors.grey, width: 0.5), // 边色与边宽度
                  color: Colors.white, // 底色
                  shape: BoxShape.circle, // 圆形,使用圆形时不可以使用borderRadius
                ),
                alignment: Alignment.center,
                child: IconButton(
                  icon: Icon(Icons.done),
                  onPressed: () {
                    widget.onOk(context, _imagePath);
                  },
                ),
              ),
            ),
          ],
        ),
      );
    }

    return Scaffold(
      body: FutureBuilder<void>(
        future: _initializeControllerFuture,
        builder: (context, snapshot) {
          if (snapshot.connectionState == ConnectionState.done) {
            return CameraPreview(_controller);
          } else {
            return Center(child: CircularProgressIndicator());
          }
        },
      ),
      floatingActionButton: FloatingActionButton(
        child: Icon(Icons.camera_alt),
        onPressed: () async {
          try {
            await _initializeControllerFuture;

            final String path = join(
              (await getTemporaryDirectory()).path,
              '${DateTime.now()}.png',
            );

            await _controller.takePicture(path);
            setState(() {
              _imagePath = path;
            });
          } catch (e) {
            print(e);
          }
        },
      ),
    );
  }
}

点击按钮,获取相机,跳转到拍照页面

仅有拍照页面是无法完成拍照功能的,下面模拟在主页面点击按钮,我们需要获取手机上可用的相机,之后跳转到拍照页面。

onOk 方法接收两个参数:

  • context 拍照页面(TakePictureScreen)的上下文,用于处理完业务逻辑后手动调用 Navigator.pop(context) 退出拍照页面;
  • imagePath 在拍照页面进行拍摄后,照片会暂时存储在手机本地上,这个参数是存在手机上的路径;
IconButton(
    icon: Icon(Icons.camera_alt),
    onPressed: () async {
        // 获取手机上可用的所有相机,返回值是个数组
        final List<CameraDescription> cameras =
            await availableCameras();

        Navigator.push(
            context,
            MaterialPageRoute(
            builder: (context) => TakePictureScreen(
                camera: cameras.first,  // 使用数组中的第一个相机
                onOk: (BuildContext context, String imagePath) async {
                    // ......
                },
            ),
            ),
        );
    },
),

将拍摄的图片上传到服务器

完善前一步骤的 onOk 函数体内容,使用 dio(v3.0.0) 网络请求库上传图片。

onOk: (BuildContext context, String imagePath) async {
    // 上传图片
    FormData formData = FormData.fromMap({
      'photo': await MultipartFile.fromFile(imagePath,
          filename: '${DateTime.now()}.png'),
    });
    Response result = await HttpUtils.getInstance().post(
      '/upload',
      data: formData,
      options: Options(headers: {
        'Authorization': 'Bearer ' + token,
      }),
    );

    print('result = $result');

    // 业务逻辑处理完,记得退出拍照页面
    Navigator.pop(context);
},

可能出现的报错

启动项目,可能会出现一些错误,总结如下:

Unhandled Exception: MissingPluginException(No implementation found for method canLaunch on channel plugins.flutter.io/url_launcher)

字面意思是插件找不到。

造成这个报错的原因是:我们先启动了 Flutter 应用,之后再去 pubspec.yaml 文件添加 camera 插件,此时是无法生效的,会报插件丢失的错误。

解决方法:关闭 Flutter 应用,重新启动即可。

更多细节

uses-sdk:minSdkVersion 16 cannot be smaller than version 21 declared in library

字面意思,第三方库 camera 要求 minSdkVersion 版本最低为 21,但是我们项目里自带的 minSdkVersion 版本是 16,不兼容导致报错。

解决方法:将项目的 minSdkVersion 版本号手动改为 21 即可。

修改方法:在根目录下找到 /android/app/build.gradle 文件:

defaultConfig {
    applicationId "com.example.projectname"
    minSdkVersion 21   // <===================== 更改成 21,之前的默认值是 16
    targetSdkVersion 28
    versionCode 1
    versionName "1.0"
    testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
}

更多细节

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 212,080评论 6 493
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,422评论 3 385
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 157,630评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,554评论 1 284
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,662评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,856评论 1 290
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,014评论 3 408
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,752评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,212评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,541评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,687评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,347评论 4 331
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,973评论 3 315
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,777评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,006评论 1 266
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,406评论 2 360
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,576评论 2 349