强制决策方法
强制决策方法
本主题介绍 Swift SDK 的强制决策方法，可以使用这些方法强制用户进入云眼特性标帜(Feature Flag)AB实验中的特定变体。
这些方法将通过强制用户进入特定变体来帮助测试和调试客户端应用程序的各种流。
Swift SDK 将在做出任何决策之前检查强制决策。如果找到所请求标帜的匹配项，Swift SDK 会在做出正常决策之前立即返回强制决策（忽略受众条件和流量分配）。
下面描述了 Swift SDK 将遵循的具体场景：
标记到决策
- SDK 将在给定标帜的任何决策调用开始时查找。如果为该标帜找到匹配的标帜到决策强制决策，它将返回该决定。
从实验规则到决策
- SDK 将在决策开始时查找给定实验规则（标帜键）。如果为标帜找到匹配的实验规则到决策强制决策，它将返回决策。
从交付规则到决策
- SDK 将在决策开始时查找给定的传递规则（标帜键）。如果找到匹配的传递规则到决策强制决策，它将返回该决策。
❗️
警告
在调用任何强制决策方法之前，必须将变体关联到标帜规则。
对于强制决策，SDK 会像其他正常决策一样触发展示事件和通知（除非被 disableDecisionEvent 选项禁用）。
📘 注意
这些强制决策不是永久性的，将在重新初始化 EyeofcloudUserContext 时清除。
有关每种方法的更多信息，请单击下面的方法名称：
云眼分桶结果 EyeofcloudDecision上下文
Swift
public struct EyeofcloudDecisionContext {
public let flagKey: String
public let ruleKey: String?
}云眼强制决策
Swift
public struct EyeofcloudForcedDecision {
public let variationKey: String
}设置强制决策方法 - setForcedDecision（）
版本
3.10.0
描述
为给定的EyeofcloudDecisionContext设置强制决策（variationKey）。
参数
下表列出了 Swift SDK 的必需参数和可选参数。
| 参数 | 类型 | 描述 |
|---|---|---|
| 所需的上下文 | 结构 | EyeofcloudDecisionContext的实例，其中包含要获取的强制决策的必需flagKey和可选ruleKey。 |
| (必选)决定 | 结构 | EyeofcloudForcedDecision的实例，其中包含要设置的强制variationKey决策所需的实例。 |
返回
一个布尔值，指示是否成功完成了强制决策（variationKey） 的设置。
例
在此处查看完整的 Swift SDK 示例。
获取强制决策方法 - getForcedDecision（）
变体
3.10.0
描述
返回给定EyeofcloudDecisionContext的强制决策（variationKey）。返回EyeofcloudForcedDecision实例，如果没有匹配项，则返回 null。
参数
下表列出了 Swift SDK 的必需参数和可选参数。
| 参数 | 类型 | 描述 |
|---|---|---|
| 所需的上下文 | 结构 | EyeofcloudDecisionContext的实例，其中包含要获取的强制决策的必需flagKey和可选ruleKey。 |
返回
上下文的强制决策EyeofcloudForcedDecision实例，如果没有匹配项，则为 null。
例
在此处查看完整的 Swift SDK 示例。
删除强制决策方法 - 删除强制决策（）
变体
3.10.0
描述
删除给定EyeofcloudDecisionContext的强制决策（variationKey）。
参数
下表列出了 Swift SDK 的必需参数和可选参数。
| 参数 | 类型 | 描述 |
|---|---|---|
| 所需的上下文 | 结构 | EyeofcloudDecisionContext的实例，其中包含要获取的强制决策的必需flagKey和可选ruleKey。 |
返回
删除强制决策（variationKey） 时的成功/失败布尔状态。
例
在此处查看完整的 Swift SDK 示例。
删除所有强制决策方法 - 删除所有强制决策（）
变体
3.10.0
描述
删除用户上下文的所有强制决策（variationKey）。
参数
下表列出了 Swift SDK 的必需参数和可选参数。
| 参数 | 类型 | 描述 |
|---|---|---|
| 没有 | 不适用 | 不适用 |
返回
成功/失败布尔状态。
例
在此处查看完整的 Swift SDK 示例。
完整代码示例
Swift
let eyeofcloud = EyeofcloudClient(sdkKey: “sdk-key”)
eyeofcloud.start(datafile: datafile)
let user = eyeofcloud.createUserContext(userId: “test-user”, attributes: attributes)
let flagContext = EyeofcloudDecisionContext(flagKey: "flag-1")
let flagAndABTestContext = EyeofcloudDecisionContext(flagKey: "flag-1", ruleKey: "ab-test-1")
let flagAndDeliveryRuleContext = EyeofcloudDecisionContext(flagKey: "flag-1", ruleKey: "delivery-1")
let variationAForcedDecision = EyeofcloudForcedDecision(variationKey: "variation-a")
let variationBForcedDecision = EyeofcloudForcedDecision(variationKey: "variation-b")
let variationOnForcedDecision = EyeofcloudForcedDecision(variationKey: "on")
// set a forced decision for a flag
var success = user.setForcedDecision(context: flagContext, decision: variationAForcedDecision)
decision = user.decide(key: "flag-1")
// set a forced decision for an ab-test rule
success = user.setForcedDecision(context: flagAndABTestContext, decision: variationBForcedDecision)
decision = user.decide(key: "flag-1")
// set a forced variation for a delivery rule
success = user.setForcedDecision(context: flagAndDeliveryRuleContext, decision: variationOnForcedDecision) decision = user.decide(key: "flag-1")
// get forced variations
let forcedDecision = user.getForcedDecision(context: flagContext)
print("[ForcedDecision] variationKey = \(forcedDecision!.variationKey)")
// remove forced variations
success = user.removeForcedDecision(context: flagAndABTestContext)
success = user.removeAllForcedDecisions()参见
源文件
包含 Swift 实现的语言/平台源文件是 EyeofcloudClient.swift。