本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
创建和管理函数
此页面引导您使用 MediaTailor 控制台创建、附加、更新和删除函数。函数允许您通过在播放期间在关键点运行逻辑来自定义会话行为和广告请求。
设置函数
使用控制台创建函数
-
打开 MediaTailor 控制台
。 -
在导航窗格中，选择函数。
-
选择创建函数。
-
对于函数 ID，输入函数的唯一名称（例如，
fetchIdentity）。 -
对于函数类型，选择
CUSTOM_OUTPUTHTTP_REQUEST、VAST_REQUEST、SEQUENTIAL_EXECUTOR、或CONCURRENT_EXECUTOR。控制台显示所选类型的配置字段。 -
填写特定类型的配置字段。有关每种函数类型及其字段的描述，请参阅函数类型和构成。
-
选择创建函数。
将功能附加到播放配置
只有通过函数映射（生命周期挂钩和函数之间的链接）将函数附加到回放配置，该函数才会运行。函数映射指定哪个生命周期挂钩触发该函数。
-
打开控制 MediaTailor 台。
-
在导航窗格中，选择配置。
-
选择要更新的播放配置。
-
在函数映射部分中，选择编辑。
-
对于每个生命周期挂钩，选择要附加的函数：
-
会话初始化挂钩 -选择一个在会话启动时运行一次的函数。
-
广告请求挂钩 -选择要在每个 ADS 请求之前运行的函数。
-
发布广告回复挂钩 — 选择一个函数，在收到并解析每个 ADS 回复后运行。
-
清单前插入挂钩 -选择一个函数，在广告插入清单之前，在最终广告集上运行。
-
-
选择保存。
管理函数
查看函数
导航到 “功能” 以查看您账户中的所有功能。选择函数名称以查看其配置。
更新现有函数
要更新函数，请导航到函数，选择该函数，然后修改配置。此更新取代了整个函数定义。
提示
在进行更改之前，请保存函数配置的副本。函数没有内置版本控制或回滚功能。
移除函数
将功能从播放配置中分离
在删除某个函数之前，请将其从所有引用该函数的播放配置中移除。
-
打开控制 MediaTailor 台。
-
在导航窗格中，选择配置。
-
选择播放配置。
-
在函数映射部分中，选择编辑。
-
将该函数从生命周期挂钩中移除。
-
选择保存。
删除函数
导航到函数，选择函数，然后选择删除。
删除阻止规则
MediaTailor 防止您删除仍在使用的函数。
| 条件 | 结果 |
|---|---|
| 通过功能映射将功能附加到播放配置 | 删除已被阻止。先分离该函数。 |
在SEQUENTIAL_EXECUTOR或中引用函数 CONCURRENT_EXECUTOR |
删除已被阻止。首先从父函数中删除引用。 |
| 任何地方都没有引用函数 | 删除成功。 |
验证规则
MediaTailor 在您创建或更新函数时对其进行验证。执行以下检查：
-
表达式语法 -所有表达式都必须是有效的 JsoNata。
-
受限函数 -表达式无法调用受限的 JsoNata 函数。JSONata表达式参考有关完整列表，请参见。
-
输出密钥前缀 -所有输出键必须以可识别的命名空间前缀开头。有关可接受的前缀列表，请参见生命周期钩子。
-
函数引用 -中的所有函数 ID 都
FunctionList必须引用现有函数。 -
循环引用 — 函数不能直接或间接引用自身。
-
嵌套深度 — A
SEQUENTIAL_EXECUTOR可以调用其他函数，但这些函数本身不能成为执行器。
有关具体值和大小限制，请参见限制。
API 参考
要以编程方式管理函数，请参阅 AWS Elemental MediaTailor API 参考。
