使用@capgo/capacitor-live-activities

Capacitor实时活动插件接口，用于管理iOS实时活动

安装

bun add @capgo/capacitor-live-activities
bunx cap sync

iOS设置

安装和同步插件不会创建原生实时活动UI。在调用之前， startActivity在Xcode中配置ActivityKit：

运行 bunx cap open ios.
添加一个 小部件扩展 目标和启用 包含实时活动.
将应用程序和小部件扩展的部署目标设置为 iOS 16.1 或更高版本。
确保扩展嵌入在主应用程序中。
保持一个 ActivityConfiguration 已注册在扩展的 WidgetBundle,包括锁屏和所有动态岛屿演示。
添加 NSSupportsLiveActivities 到主应用程序目标的 Info.plist.

<key>NSSupportsLiveActivities</key>
<true/>

仅添加目标是不够的。原生应用程序或插件必须调用 ActivityKit 的 request、update 和 end API。小部件扩展必须包含 SwiftUI code，可以解码和渲染相同的内容 ActivityAttributes 和这些调用使用的内容状态。包括在主应用程序和小部件扩展目标中共享的ActivityKit模型。Xcode生成的Live Activity模板不会自动渲染传递给此插件的JSON布局；扩展还需要兼容的本机布局渲染器。

共享图片

当使用图片管理方法时，添加 应用组 到主应用程序和小部件扩展目标。使用插件期望的exact标识符在两个目标上启用相同的组：

group.<MAIN_APP_BUNDLE_ID>.liveactivities

Live Activity扩展无法访问网络。下载主应用程序中的远程图片，保存到共享的App Group中， saveImage，然后从布局中引用保存的图片。捆绑资产也必须属于小部件扩展目标。

深度链接和推送更新

注册 behavior.widgetUrl 或 tapUrl 在主应用程序目标的 信息>URL类型 设置.
为了实现服务器驱动的更新，请添加 推送通知 能力，并使用 APNs 实现 ActivityKit 推送令牌处理.
添加 NSSupportsLiveActivitiesFrequentUpdates 仅当应用程序需要频繁的 ActivityKit 推送更新时才添加.

仅仅启用推送通知能力是不够的；服务器驱动的更新需要原生令牌处理和 APNs 后端.

ActivityKit 将静态和动态 Live 活动数据的组合限制在 4 KB 内。动态岛屿仅在支持的设备模型上可见；其他设备使用锁屏显示.

此插件暴露的内容

areActivitiesSupported - 检查是否在此设备上支持 Live 活动。需要 iOS 16.1+ 和设备支持.
startActivity - 使用指定的布局和数据启动一个新的 Live 活动.
updateActivity - 使用新数据更新一个现有的 Live 活动.
endActivity - 结束实时活动。

示例用途

`areActivitiesSupported`

检查此设备是否支持实时活动。需要 iOS 16.1+ 和设备支持。

import { CapgoLiveActivities } from '@capgo/capacitor-live-activities';

const { supported, reason } = await CapgoLiveActivities.areActivitiesSupported();
if (supported) {
  console.log('Live Activities are supported!');
} else {
  console.log('Not supported:', reason);
}

`startActivity`

使用指定布局和数据启动一个新的实时活动。

import { CapgoLiveActivities } from '@capgo/capacitor-live-activities';

const { activityId } = await CapgoLiveActivities.startActivity({
  layout: {
    type: 'container',
    direction: 'horizontal',
    children: [
      { type: 'text', content: 'Order #{{orderNumber}}', fontSize: 16, fontWeight: 'bold' },
      { type: 'text', content: '{{status}}', fontSize: 14, color: '#666666' }
    ]
  },
  dynamicIslandLayout: {
    expanded: {
      leading: { type: 'image', source: 'sfSymbol', value: 'box.truck' },
      trailing: { type: 'text', content: '{{eta}}' },
      center: { type: 'text', content: '{{status}}' },
      bottom: { type: 'progress', value: 'progress' }
    },
    compactLeading: { type: 'image', source: 'sfSymbol', value: 'box.truck' },
    compactTrailing: { type: 'text', content: '{{eta}}' },
    minimal: { type: 'image', source: 'sfSymbol', value: 'box.truck' }
  },
  data: {
    orderNumber: '12345',
    status: 'On the way',
    eta: '10 min',
    progress: 0.6
  }
});
console.log('Started activity:', activityId);

`updateActivity`

更新一个现有的实时活动以使用新的数据。

import { CapgoLiveActivities } from '@capgo/capacitor-live-activities';

await CapgoLiveActivities.updateActivity({
  activityId: 'abc123',
  data: {
    status: 'Arrived!',
    eta: 'Now',
    progress: 1.0
  },
  alertConfiguration: {
    title: 'Delivery Update',
    body: 'Your order has arrived!'
  }
});

`endActivity`

结束一个实时活动。

import { CapgoLiveActivities } from '@capgo/capacitor-live-activities';

await CapgoLiveActivities.endActivity({
  activityId: 'abc123',
  data: { status: 'Delivered' },
  dismissalPolicy: 'after',
  dismissAfter: Date.now() + 3600000 // 1 hour from now
});

完整参考

GitHub: https://github.com/Cap-go/capacitor-live-activities/
文档：/docs/plugins/live-activities/

继续使用 @capgo/capacitor-live-activities

如果您正在使用 使用@capgo/capacitor-live-activities 规划原生媒体和界面行为，连接它与 @capgo/capacitor-live-activities @capgo/capacitor-live-activities的实现细节在@capgo/capacitor-live-activities中开始使用 @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-live-activities的实现细节在开始使用中使用@capgo/capacitor-video-player @capgo/capacitor-video-player的原生能力在使用@capgo/capacitor-video-player中 @capgo/capacitor-video-player @capgo/capacitor-video-player的实现细节在@capgo/capacitor-video-player中，使用@capgo/capacitor-native-navigation @capgo/capacitor-native-navigation的原生能力在使用@capgo/capacitor-native-navigation中.

实时活动

实时活动教程