强制决策方法
强制决策方法
本主题介绍 Harmony SDK 的强制决策方法，可用于强制用户进入云眼特性标帜(Feature Flag)AB实验中的特定变体。
这些方法将通过强制用户进入特定变体来帮助测试和调试客户端应用程序的各种流。
Harmony SDK 将在做出任何决定之前检查强制决策。如果找到请求标帜的匹配项，SDK 会在做出正常决策之前立即返回强制决策（忽略受众条件和流量分配）。
下面描述了 Harmony SDK 将遵循的特定场景：
标记到决策
- SDK 将在给定标帜的任何决策调用开始时查找。如果为该标帜找到匹配的标帜到决策强制决策，它将返回该决定。
从实验规则到决策
- SDK 将在决策开始时查找给定实验规则（标帜键）。如果为标帜找到匹配的实验规则到决策强制决策，它将返回决策。
从交付规则到决策
- SDK 将在决策开始时查找给定的传递规则（标帜键）。如果找到匹配的传递规则到决策强制决策，它将返回该决策。
❗️
警告
在调用任何强制决策方法之前，必须将变体关联到标帜规则。
对于强制决策，SDK 会像其他正常决策一样触发展示事件和通知（除非被 disableDecisionEvent 选项禁用）。
📘 注意
这些强制决策不是永久性的，将在重新初始化 EyeofcloudUserContext 时清除。
云眼分桶结果 EyeofcloudDecision上下文
export interface EyeofcloudDecisionContext { flagKey: string; ruleKey?: string; }云眼强制决策
export interface EyeofcloudForcedDecision { variationKey: string; }设置强制决策方法- setForcedDecision()
描述
为给定的EyeofcloudDecisionContext设置强制决策（variationKey）。
参数
下表列出了 Harmony SDK 的必需参数和可选参数。
| 参数 | 类型 | 描述 |
|---|---|---|
| 所需的_上下文 | 接口 | EyeofcloudDecisionContext的实例，其中包含要获取的强制决策的必需flagKey和可选ruleKey。 |
| (必选)决定 | 接口 | EyeofcloudForcedDecision的实例，其中包含要设置的强制variationKey决策所需的实例。 |
返回
一个布尔值，指示是否成功完成了强制决策（variationKey）的设置。
例子
查看完整鸿蒙SDK示例 here.
获取强制决策方法 - getForcedDecision（）
描述
返回给定EyeofcloudDecisionContext的强制决策 （variationKey）。返回EyeofcloudForcedDecision实例，如果没有匹配项，则返回 null。
参数
下表列出了 Android SDK 的必需参数和可选参数。
| 参数 | 类型 | 描述 |
|---|---|---|
| 所需的上下文 | 结构 | EyeofcloudDecisionContext的实例，其中包含要获取的强制决策的必需flagKey和可选ruleKey。 |
返回
上下文的强制决策EyeofcloudForcedDecision实例，如果没有匹配项，则为 null。
例子
在此处查看完整的 Harmony SDK 示例。
删除强制决策方法 - 删除强制决策（）
描述
删除给定EyeofcloudDecisionContext的强制决策（variationKey）。
参数
下表列出了 Harmony SDK 的必需参数和可选参数。
| 参数 | 类型 | 描述 |
|---|---|---|
| 所需的上下文 | .class | EyeofcloudDecisionContext的实例，其中包含要获取的强制决策的必需flagKey和可选ruleKey。 |
返回
删除强制决策（variationKey）时的成功/失败布尔状态。
例子
在此处查看完整的 Harmony SDK 示例。
删除所有强制决策方法 - 删除所有强制决策（）
描述
删除用户上下文的所有强制决策 （variationKey）。
参数
下表列出了 Harmony SDK 的必需参数和可选参数。
| 参数 | 类型 | 描述 |
|---|---|---|
| 没有 | 不适用 | 不适用 |
返回
一个成功/失败布尔状态
例子
查看完整鸿蒙SDK示例 here.
代码示例
import { createInstance } from 'eyeofclouf/src/packages/eyeofcloud-sdk/lib/index.node'
const eyeofcloudClient = createInstance({sdk: 'sdk_key' //Provide the sdkKey of your desired environment here });
const user = eyeofcloudClient.createUserContext('test_user', attributes)
let success, decision, forcedDecision;
// set a forced decision for a flag
success = user.setForcedDecision({flagKey: 'flag-1'}, {variationKey: 'variation-a'});
decision = user.decide('flag-1');
// set a forced decision for an ab-test rule
success = user.setForcedDecision({flagKey: 'flag-1', ruleKey: 'ab-test-1'}, {variationKey: 'variation-b'});
decision = user.decide('flag-1');
// set a forced variation for a delivery rule
success = user.setForcedDecision({flagKey: 'flag-1', ruleKey: 'delivery-1'}, {variationKey: 'on'});
decision = user.decide('flag-1');
//get foced variations
forcedDecisoon = user.getForcedDecisoon({flagKey: 'flag-1'});
// remove forced variations
success = user.removeForcedDecision({flagKey: 'flag-1', ruleKey: 'ab-test-1'});
user.removeAllForcedDecisions();