本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 具有資訊清單活動訊號的引導式預先擷取
<a name="sgai-guided-prefetch"></a>

對於即時 SGAI 串流，您可以透過將 `aws.guidedPrefetchMode=MANIFEST`新增至工作階段初始化請求來啟用資訊清單型廣告預先擷取：

```
https://777788889999.mediatailor.us-east-1.amazonaws.com/v1/master/777788889999/myOrigin/index.m3u8?aws.insertionMode=GUIDED&aws.guidedPrefetchMode=MANIFEST
```

啟用時，MediaTailor 會將工作階段識別符 (`?aws.sessionId=<id>`) 做為查詢參數附加至多變量播放清單中的每個間質媒體資訊清單 (`/v1/i-media`) URL。每次播放器重新整理 i-media 資訊清單時，請求都會使用工作階段 ID 到達 MediaTailor，MediaTailor 會使用此 ID 來為即將到來的廣告休息時間排入預先擷取請求的佇列。
+ `aws.guidedPrefetchMode` 參數接受兩個值： `MANIFEST` （啟用） 和 `OFF`（停用，預設值）。
+ 引導式預先擷取模式僅適用於 SGAI 工作階段。搭配拼接工作階段使用會傳回錯誤。
+ DASH 尚不支援引導式預先擷取模式。
+ 引導式預先擷取與報告模式無關 — 信標會在播放時間觸發，而不是在預先擷取時間觸發。
+ **使用引導式預先擷取時，請勿在 CDN 中快取 i-media 資訊清單。**預先擷取機制取決於玩家的資訊清單重新整理請求是否直接到達 MediaTailor。如果您的 CDN 快取`/v1/i-media`回應，MediaTailor 不會接收活動訊號請求，也無法觸發預先擷取。