@flare-engine/share (英语)

跨平台截图抓取( Skia) makeImageSnapshot) + 有可插件的共享表管弦乐. captureScreenshot(source, opts?) 返回时 { bytes, base64, format, width, height }。 。 。 . ShareManager 通过注册运输的级联——第一个 canShare(payload) 返回真正的胜利。 内建运输覆盖了Web Share API,Web Clipboard回落,原生RN Share,以及 expo-sharing (图像文件,用于Android截图). createScreenshotScene 电线为存储资产工作流程的一发捕捉场景.

安装

bun add @flare-engine/share

使用量

import { Share } from 'react-native';
import { captureScreenshot, ShareManager, createNativeShareTransport,
         createWebShareTransport, createWebClipboardTransport } from '@flare-engine/share';
import type { CaptureSource } from '@flare-engine/share';

declare const source: CaptureSource;

const shot = captureScreenshot(source, { format: 'png' });

const share = new ShareManager()
  .register(createNativeShareTransport(Share))
  .register(createWebShareTransport(navigator, File))
  .register(createWebClipboardTransport(navigator));

if (shot) {
  await share.share({ message: 'New high score! https://example.com', screenshot: shot });
}

平台注释:

• createWebShareTransport 附加截图为 File 浏览器时 navigator.canShare({ files }) 接受这个.
• createNativeShareTransport 在iOS上标注为 data:image/<format>;base64,… URL,仅限 何时 url 是未设定的——一个明确的 url 胜出时没有图像连接 。 Android的RN (英语) Share 仅转发 title 财务报告和审定财务报表 message,所以在 message图像没有附着在那里, 和带有截图但无 message 打开一个仍为报告的空工作表 dispatched: true。 。 。 .
• createWebClipboardTransport 副本 message 财务报告和审定财务报表 url 只有文本.
• createExpoShareTransport 共享截图为图像文件;见下文.

Android 截图

核弹 Share 无法在 Android 上附加图像 . createExpoShareTransport(sharing, files) 写入 将截图切入文件并将其 URI 交给 expo-sharing注册 在此之前 红色 运输: canShare 只有当有效载荷具有 screenshot,所以截图有效载荷 到达 expo-sharing 和仅文本的有效载荷流入RN Share。 。 。 .

import { Share } from 'react-native';
import * as Sharing from 'expo-sharing';
import { File, Paths } from 'expo-file-system';
import { createExpoShareTransport, createNativeShareTransport, ShareManager } from '@flare-engine/share';
import type { ShareFileWriterLike } from '@flare-engine/share';

const files: ShareFileWriterLike = {
  async writeBase64File(name, base64) {
    const f = new File(Paths.cache, name);
    await f.write(base64, { encoding: 'base64' });
    return f.uri;
  },
};

const share = new ShareManager()
  .register(createExpoShareTransport(Sharing, files))
  .register(createNativeShareTransport(Share));

files 一个回调,将 Base64 数据写入文件并解析其 URI 。 适配器 上方使用 File API 数据 expo-file-system 58号,其中 write 创建文件或覆盖 这个 与 expo-file-system/legacy 条目中,用这样的方式写:

import { cacheDirectory, writeAsStringAsync } from 'expo-file-system/legacy';
import type { ShareFileWriterLike } from '@flare-engine/share';

const files: ShareFileWriterLike = {
  async writeBase64File(name, base64) {
    const uri = `${cacheDirectory}${name}`;
    await writeAsStringAsync(uri, base64, { encoding: 'base64' });
    return uri;
  },
};

限制 :

• expo-sharing 共享一个文件而无文本。 截图独出: message 财务报告和审定财务报表 url 被丢弃,以及 title 成为选择者的 dialogTitle。 。 。 .
• 文件总是被命名 screenshot.<format>,因此每个共享覆盖上一个共享.
• 结果是 { dispatched: true, via: 'native' } 一旦工作表打开; expo-sharing 不表示用户是否完成了该共享。 何时 isAvailableAsync() 断绝虚假, 什么都没有写,结果就是 { dispatched: false, via: 'native' }。失败的书写或 被拒绝 shareAsync 拒绝 share() 答应.

见 API 规格。 。 。 .

许可证

阿帕奇 - 2.0