範例程式碼
生成建議項目的列表
local RecommendationService = game:GetService("RecommendationService")
-- 定義生成建議列表的請求
local request: GenerateRecommendationItemListRequest = {
ConfigName = "MaximizeEngagement",
LocationId = "Lobby",
PageSize = 10
-- 注意:取消註解並為伺服器腳本設置 CustomContexts.UserId。
-- 對於本地腳本無需設置。
-- CustomContexts = {
-- ["UserId"] = tostring(player.UserId),
-- }
}
-- 呼叫 GenerateItemListAsync 以獲取建議頁面
local success, recommendationPages = pcall(function()
return RecommendationService:GenerateItemListAsync(request)
end)
if success then
-- 獲取當前頁面的建議項目
local currentPage = recommendationPages:GetCurrentPage()
for _, item in ipairs(currentPage) do
print("項目 ID: " .. item.ItemId)
print(" 參考 ID: " .. item.ReferenceId)
print(" 跟踪 ID: " .. item.TracingId)
end
else
warn("RecommendationService 錯誤: " .. tostring(recommendationPages))
end
--[[ 每個項目在頁面中的返回數據格式
{
"ItemId": string,
"ReferenceId": string,
"TracingId": string,
"Creator": {
"CreatorId": number,
"CreatorType": Enum.CreatorType,
}?,
"Attributes": {
{
"AssetId": number?,
"Text": string?,
"Description": string?,
"SeekStartTime": number?,
"SeekEndTime": number?,
"TrimStartTime": number?,
"TrimEndTime": number?
}
}?,
"CustomTags": { string }?
}
--]]