Skip to content

Z
zw_game_sdk
提交 7574c941 作者: zhaoyy
操作

Merge branch 'ios_zlj' into release

上级 43415b28 216694e5
正在显示 包含 124 行增加 和 21 行删除
iossdk_appstore对接说明文档_含广告分享.md
## ZYouSDK V1.0.0文档接入使用 ## ZYouSDK V1.0.0文档接入使用
...@@ -353,32 +353,39 @@ app启动时调用注册sdk ----在AppDelegate 中调用以下方法 ...@@ -353,32 +353,39 @@ app启动时调用注册sdk ----在AppDelegate 中调用以下方法
### 调用示例<a name="sec6.2"></a> ### 调用示例<a name="sec6.2"></a>
``` ```
// title: ActionSheet 显示的选项标题
// productId: Apple IAP 商品 ID
// name: 订单中的商品名称
// amount: 金额（单位：分）
// type: 1-消耗型 2-非续期订阅(一次性月卡) 3-自动续费VIP月卡 4-自动续费免广告月卡
NSDictionary *order = @{ NSDictionary *order = @{
@"cp_order_id":@"1531691516911368192_16006_9690822_425", //CP订单ID @"cp_order_id":[NSString stringWithFormat:@"sub_%@_%ld", productId, (long)[[NSDate date] timeIntervalSince1970]],
@"amount":@"1", //商品总价（单位：分） @"amount":amount,
@"product_price":@"1", //商品价格（单价，单位：分） @"product_price":amount,
@"product_id":@"16006", //商品ID @"product_id":productId,
@"product_cnt":@"1", //商品数量 @"product_cnt":@"1",
@"product_name":@"周三直购", //商品名称 @"product_name":productName,
@"product_desc":@"0.1元惊喜包", //商品描述 @"product_desc":productName,
@"ext":@"1531691514967582720", //订单额外信息用（json） @"ext":@"",
@"product_type":type,
}; };
NSDictionary *role = @{ NSDictionary *role = @{
@"event":@"create", // 事件类型，online: 角色登录, create: 创建角色,level_up: 提升等级,offline: 角色退出,other: 其他,delete: 删除角色,main_city_upgrade:官邸升级事件,chapter_complete:章节完成事件 @"event":@"create",
@"server_id":@"100001", //区服ID @"server_id":@"1",
@"server_name":@"主宰服", //区服名称 @"server_name":@"S.1",
@"cp_role_id":@"1314900", //CP角色ID @"cp_role_id":self.cp_role_id,
@"role_name":@"test_name", //角色名称 @"role_name":@"花艺师",
@"role_level":@"100", //角色等级 @"role_level":@"5",
@"role_vip":@"7" //角色VIP等级 @"role_vip":@"0"
}; };
//roleId 角色ID //roleId 角色ID
[[ZYouManager shareInstance] zy_payWithOrder:order role:role roleId:@"1314900" successBlock:^(id _Nonnull responseObject) { [[ZYouManager shareInstance] zy_payWithOrder:order role:role roleId:@"1000026" successBlock:^(id _Nonnull responseObject) {
NSLog(@"支付成功: %@", productName);
} failureBlock:^(NSString * _Nonnull error) { }failureBlock:^(NSString * _Nonnull error) {
NSLog(@"支付失败: %@", error);
}]; }];
``` ```
...@@ -1203,5 +1210,100 @@ c)广告显示目前只有一种方法，传入需要显示的场景id即可 ...@@ -1203,5 +1210,100 @@ c)广告显示目前只有一种方法，传入需要显示的场景id即可
} }
``` ```
## 14、灵动岛实时活动<a name="sec8"></a>
### 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 自动切换，
研发方不需要传 xxx_done / xxx_growing 这类状态 eventType。
- (BOOL)startOrUpdateLiveActivityWithEventId:(NSString *)eventId
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>
&nbsp;&nbsp; 开启事件
```
NSTimeInterval maturityTimestamp = [[NSDate date] timeIntervalSince1970] + 300.0;
[[ZYouLiveActivitySDK shared] startOrUpdateLiveActivityWithEventId:@"demo-eventtype-flower_a"
eventType:@"zhonghua_1"
flowerName:@"白百合"
maturityTimestamp:maturityTimestamp];
```
### 14.4 关闭实时活动事件
```
关闭接口：eventId 非空时关闭指定实时活动；eventId 为 nil 或空字符串时关闭全部实时活动。
immediately 为 YES 时立即关闭；为 NO 时使用系统默认结束策略。
- (void)endLiveActivityWithEventId:(nullable NSString *)eventId
immediately:(BOOL)immediately;
```
### 调用示例<a name="sec11.2"></a>
&nbsp;&nbsp; 关闭事件
```
[[ZYouLiveActivitySDK shared] endLiveActivityWithEventId:@"demo-eventtype-flower_b" immediately:true];
```
\ No newline at end of file
Markdown 格式
0% 或
您添加了 0 人 到此讨论。请谨慎行事。
请先完成此评论的编辑！
请 注册 或者 后发表评论