Flutter集成Snapchat功能插件snapkit的使用

概述

snapkit 是一个允许开发者在Flutter应用程序中集成Snapchat功能的插件。通过这个插件，你可以实现登录、分享内容到Snapchat等功能。

开始使用

首先，请参考 Wiki 获取如何在现有项目中设置该插件的详细步骤。你也可以直接复制示例项目 到你的目录并重命名。

使用方法

创建新实例

Snapkit snapkit = new Snapkit();

监听AuthState流

snapkit.onAuthStateChanged.listen((SnapchatUser? user) {
    // 处理返回的SnapchatUser或null
});

实现AuthState监听器

class MyAppState extends State<MyApp> implements SnapchatAuthStateListener {

  [@override](/user/override)
  void initState() {
    super.initState();
    snapkit.addAuthStateListener(this);
  }

  [@override](/user/override)
  void onLogin(SnapchatUser user) {
    // 登录成功处理
  }

  [@override](/user/override)
  void onLogout() {
    // 注销处理
  }
}

登录与登出

登录

await snapkit.login();

// 或者使用.then()

snapkit.login().then(user => {});

登出

await snapkit.logout();

// 或者使用.then()

snapkit.logout().then(() => {});

验证手机号码

注意：在Android上始终返回false。

snapkit.verifyPhoneNumber('US', '1231234567')
  .then(isVerified {})
  .catchError((error, StackTrace stacktrace) {})

分享到Snapchat

分享到LIVE

snapkit.share(SnapchatMediaType.NONE,
  sticker: SnapchatSticker?,
  caption: String?,
  attachmentUrl: String?
);

带背景图片分享

snapkit.share(SnapchatMediaType.PHOTO,
  image: ImageProvider,
  sticker: SnapchatSticker?,
  caption: String?,
  attachmentUrl: String?
);

带背景视频分享

注意：目前不支持Android平台。

snapkit.share(SnapchatMediaType.VIDEO,
  videoUrl: String,
  sticker: SnapchatSticker?,
  caption: String?,
  attachmentUrl: String?
);

创建SnapchatSticker

new SnapchatSticker(
  image: ImageProvider
);

示例代码

下面是一个完整的示例代码，展示了如何集成和使用snapkit插件：

import 'package:flutter/material.dart';
import 'dart:async';
import 'package:snapkit/snapkit.dart';

void main() {
  runApp(MyApp());
}

class MyApp extends StatefulWidget {
  [@override](/user/override)
  _MyAppState createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  GlobalKey<ScaffoldMessengerState> _scaffoldMessengerKey = GlobalKey<ScaffoldMessengerState>();
  SnapchatUser? _snapchatUser;
  Snapkit _snapkit = Snapkit();
  TextEditingController _regionController = TextEditingController(text: 'US');
  TextEditingController _phoneController = TextEditingController(text: '0001234567');
  bool _isSnackOpen = false;

  late StreamSubscription<SnapchatUser?> subscription;

  [@override](/user/override)
  void initState() {
    super.initState();
    subscription = _snapkit.onAuthStateChanged.listen((SnapchatUser? user) {
      setState(() {
        _snapchatUser = user;
      });
    });
  }

  [@override](/user/override)
  void dispose() {
    super.dispose();
    subscription.cancel();
  }

  Future<void> loginUser() async {
    try {
      bool installed = await _snapkit.isSnapchatInstalled;
      if (installed)
        await _snapkit.login();
      else if (!_isSnackOpen) {
        _isSnackOpen = true;
        _scaffoldMessengerKey.currentState!
            .showSnackBar(SnackBar(content: Text('Snapchat App not Installed.')))
            .closed
            .then((_) {
          _isSnackOpen = false;
        });
      }
    } on PlatformException catch (exception) {
      print(exception);
    }
  }

  Future<void> logoutUser() async {
    try {
      await _snapkit.logout();
    } on PlatformException catch (exception) {
      print(exception);
    }

    setState(() {
      _snapchatUser = null;
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: ScaffoldMessenger(
        key: _scaffoldMessengerKey,
        child: Scaffold(
          appBar: AppBar(title: const Text('Snapkit Example App')),
          body: Center(
            child: Column(
              mainAxisAlignment: MainAxisAlignment.center,
              children: [
                if (_snapchatUser != null)
                  Container(
                    width: 50,
                    height: 50,
                    margin: EdgeInsets.all(15),
                    child: CircleAvatar(
                      backgroundColor: Colors.lightBlue,
                      foregroundImage: NetworkImage(_snapchatUser!.bitmojiUrl ?? "https://st.depositphotos.com/1052233/2885/v/600/depositphotos_28850541-stock-illustration-male-default-profile-picture.jpg"),
                    ),
                  ),
                if (_snapchatUser != null) Text(_snapchatUser!.displayName),
                if (_snapchatUser != null) Text(_snapchatUser!.externalId, style: TextStyle(color: Colors.grey, fontSize: 9.0)),
                if (_snapchatUser == null)
                  Container(
                    padding: EdgeInsets.only(left: 8.0, right: 8.0),
                    child: _snapkit.snapchatButton,
                  ),
                if (_snapchatUser != null)
                  TextButton(onPressed: () => logoutUser(), child: Text('Logout')),
                Container(
                  margin: EdgeInsets.only(top: 16.0),
                  child: Row(
                    children: [
                      Spacer(),
                      ConstrainedBox(constraints: BoxConstraints(maxWidth: 25), child: TextField(controller: _regionController, keyboardType: TextInputType.text)),
                      Spacer(),
                      ConstrainedBox(constraints: BoxConstraints(maxWidth: 150), child: TextField(controller: _phoneController, keyboardType: TextInputType.phone)),
                      Spacer(),
                      TextButton(
                        onPressed: () => _snapkit.verifyPhoneNumber(_regionController.text, _phoneController.text).then((isVerified) => _scaffoldMessengerKey.currentState?.showSnackBar(SnackBar(content: Text('Phone Number is ${isVerified ? '' : 'not '}verified')))).catchError((error, StackTrace stacktrace) {
                          _scaffoldMessengerKey.currentState?.showSnackBar(SnackBar(content: Text((error as PlatformException).details)));
                        }),
                        child: Text('Verify'),
                      ),
                      Spacer(),
                    ],
                  ),
                ),
              ],
            ),
          ),
          floatingActionButton: FloatingActionButton(
            onPressed: () {
              _snapkit.share(
                SnapchatMediaType.PHOTO,
                image: NetworkImage('https://picsum.photos/${(this.context.size!.width.round())}/${this.context.size!.height.round()}.jpg'),
                sticker: SnapchatSticker(
                  image: Image.asset('assets/images/icon-256x256.png').image,
                  size: Size(128, 128),
                  offset: StickerOffset(0.45, 0.45),
                  rotation: StickerRotation(15, direction: RotationDirection.COUNTER_CLOCKWISE),
                ),
                caption: 'Snapkit Example Caption!',
                attachmentUrl: 'https://JacobBrasil.com/',
              );
            },
            child: Icon(Icons.camera),
          ),
        ),
      ),
    );
  }
}