Flutter内容分享插件share_stories的使用

Flutter内容分享插件share_stories的使用

share_stories 是一个用于在Instagram和Facebook上分享媒体的插件。它支持分享到Instagram的故事、Facebook的故事以及Facebook的Reels。

开始使用

Android

1. 权限设置

   在 android/src/main/AndroidManifest.xml 文件中添加以下权限：

   <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
   <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
   

2. 配置Provider

   在 android/src/main/AndroidManifest.xml 文件中添加Provider配置：

   <provider android:name="androidx.core.content.FileProvider"
       android:authorities="${applicationId}.flutter.social_share"
       android:exported="false"
       android:grantUriPermissions="true">
       <meta-data android:name="android.support.FILE_PROVIDER_PATHS"
           android:resource="@xml/file_provider_paths" />
   </provider>
   

3. 创建file_provider_paths.xml文件

   在 android/src/main/res/xml/file_provider_paths.xml 文件中添加以下内容：

   <paths xmlns:android="http://schemas.android.com/apk/res/android">
       <external-path name="external" path="." />
       <external-files-path name="external_files" path="." />
       <external-cache-path name="external_cache" path="." />
       <files-path name="files" path="." />
   </paths>
   

4. 针对Android 11及以上版本

   需要在 android/src/main/AndroidManifest.xml 文件中添加queries标签以确保应用能够查询所需的信息：

   • 对于Instagram故事（图片）：

     <queries>
         <intent>
             <action android:name='com.instagram.share.ADD_TO_STORY' />
             <data android:mimeType='image/*' />
         </intent>
     </queries>
     

   • 对于Instagram故事（视频）：

     <queries>
         <intent>
             <action android:name='com.instagram.share.ADD_TO_STORY' />
             <data android:mimeType='video/*' />
         </intent>
     </queries>
     

   • 对于Facebook故事（图片）：

     <queries>
         <intent>
             <action android:name='com.facebook.stories.ADD_TO_STORY' />
             <data android:mimeType='image/*' />
         </intent>
     </queries>
     

   • 对于Facebook故事（视频）：

     <queries>
         <intent>
             <action android:name='com.facebook.stories.ADD_TO_STORY' />
             <data android:mimeType='video/*' />
         </intent>
     </queries>
     

   • 对于Facebook Reels（视频）：

     <queries>
         <intent>
             <action android:name='com.facebook.reels.SHARE_TO_REEL' />
             <data android:mimeType='video/*' />
         </intent>
     </queries>
     

使用示例

分享到Instagram故事

ShareStories.shareToInstagram(
    backgroundAssetUri: file.uri,
    stickerAssetUri: image.uri,
    topColor: Colors.blue,
    bottomColor: Colors.red
);

分享到Facebook故事

ShareStories.shareToStoryFacebook(
    backgroundAssetUri: file.uri,
    stickerAssetUri: image.uri,
    topColor: Colors.blue,
    bottomColor: Colors.red,
    appID: "xxxxxxxxxxxxxxxx"
);

分享到Facebook Reels

ShareStories.shareToReelsFacebook(
    backgroundAssetUri: file.uri,
    stickerAssetUri: image.uri,
    topColor: Colors.blue,
    bottomColor: Colors.red,
    appID: "xxxxxxxxxxxxxxxx"
);

完整示例Demo

以下是一个完整的示例Demo，展示了如何使用 share_stories 插件分享到Instagram故事。

import 'package:flutter/material.dart';
import 'package:share_stories/share_stories.dart';

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

class MyApp extends StatelessWidget {
  const MyApp({Key? key}) : super(key: key);

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: Text("示例"),
        ),
        body: SingleChildScrollView(
          child: Column(
            children: [
              ElevatedButton(
                onPressed: () {
                  // 假设 file 和 image 已经定义好
                  ShareStories.shareToInstagram(
                    backgroundAssetUri: file.uri,
                    stickerAssetUri: image.uri,
                    topColor: Colors.blue,
                    bottomColor: Colors.red
                  );
                },
                child: Text("分享到Instagram故事")
              )
            ],
          ),
        ),
      ),
    );
  }
}