提交 216694e5 作者: zhaoyy

添加:灵动岛实时活动

上级 9c2c4726
## ZYouSDK V1.0.0文档接入使用
## ZYouSDK V1.0.0文档接入使用
......@@ -1212,7 +1212,56 @@ c)广告显示目前只有一种方法,传入需要显示的场景id即可
## 14、灵动岛实时活动<a name="sec8"></a>
### 14.1 开启实时活动事件
### 14.1 创建并更新App工程
#### 14.1.1 为主App添加Widget Extension
![](https://cdn.nlark.com/yuque/0/2026/png/68774844/1779934893206-fb41f7f1-fb70-4b1d-ba73-35d4d500f960.png?x-oss-process=image%2Fformat%2Cwebp)
![](https://cdn.nlark.com/yuque/0/2026/png/68774844/1779934893199-8c9e8b4b-0778-4488-a0d4-656001a012f2.png?x-oss-process=image%2Fformat%2Cwebp)
#### 14.1.2 为主App和Extension设置App Group功能,并设置相同的Group ID
```
GruopID: group.com.jinzewenhua.deepseagarden
```
![](https://cdn.nlark.com/yuque/0/2026/png/68774844/1779934893343-a5a7fe0e-468b-47b3-b196-b0b8af252c57.png?x-oss-process=image%2Fformat%2Cwebp)
#### 14.1.3 引入新增的ZYouLiveActivity***.framework
```
主App引入ZYouLiveActivityCore.framework、ZYouLiveActivityShared.framework
```
![](https://cdn.nlark.com/yuque/0/2026/png/68774844/1779934893156-36eb00e0-ce4c-477c-965e-455cb6917d8d.png?x-oss-process=image%2Fformat%2Cwebp)
```
Widget Extension引入ZYouLiveActivityWidget.framework、ZYouLiveActivityShared.framework
```
![](https://cdn.nlark.com/yuque/0/2026/png/68774844/1779934893337-bf629fd7-6cee-4215-b97f-3ed3db15cb5b.png?x-oss-process=image%2Fformat%2Cwebp)
#### 14.1.4 配置Framework Search Paths
在主工程和Widget工程的Framework Search Paths下,增加:
```
$(PROJECT_DIR)/ZYouSDKDemo/LiveActivitySDK
```
### 14.2 初始化LiveSDK并调用相关API
#### 14.2.1 初始化LiveSDK
在didFinishLaunchingWithOptions中,调用SDK代码进行初始化;在Info.plist中增加Supports Live Activities Frequent Updates字段并设置为YES
```
ZYouLiveActivitySDK *sdk = [ZYouLiveActivitySDK shared];
[sdk configureDebugLogEnabled:YES deepLinkScheme:@"zmgameios.wozhangwan.com"];
[sdk configureSharedAppGroupIdentifier:@"group.com.jinzewenhua.deepseagarden"];
[sdk observeActivityUpdatesIfSupported];
[sdk observePushToStartTokenIfSupported];
```
#### 14.2.2 引用LiveWidget UI
![](https://cdn.nlark.com/yuque/0/2026/png/68774844/1779934894933-ce5d4bf0-8ec7-40ff-a41b-ab9f305d1506.png?x-oss-process=image%2Fformat%2Cwebp)
### 14.3 开启实时活动事件
```
推荐开始入口:eventType 是后台配置组 Key(如 flower_a / flower_b),不是状态 Key。
同一个 eventType 内部同时包含常规态与成熟态配置;成熟态由 maturityTimestamp / isMatured 自动切换,
......@@ -1221,6 +1270,16 @@ c)广告显示目前只有一种方法,传入需要显示的场景id即可
eventType:(NSString *)eventType
flowerName:(NSString *)flowerName
maturityTimestamp:(NSTimeInterval)maturityTimestamp;
[[ZYouLiveActivitySDK shared] startOrUpdateLiveActivityWithEventId:@"事件ID"
eventType:@"事件类型"
flowerName:@"花朵名称"
maturityTimestamp:成熟倒计时];
事件ID:具有唯一性,创建某个活动后,如果需要更新(例如使用加速卡),需要传入相同的ID
事件类型:zhonghua_1
花朵名称:玫瑰花、牡丹花等实际名称
成熟倒计时:剩余秒数
```
### 调用示例<a name="sec11.2"></a>
......@@ -1234,7 +1293,7 @@ NSTimeInterval maturityTimestamp = [[NSDate date] timeIntervalSince1970] + 300.0
maturityTimestamp:maturityTimestamp];
```
### 14.2 关闭实时活动事件
### 14.4 关闭实时活动事件
```
关闭接口:eventId 非空时关闭指定实时活动;eventId 为 nil 或空字符串时关闭全部实时活动。
immediately 为 YES 时立即关闭;为 NO 时使用系统默认结束策略。
......
Markdown 格式
0%
您添加了 0 到此讨论。请谨慎行事。
请先完成此评论的编辑!
注册 或者 后发表评论