Learn
Motor Sınıfı
RecommendationService
Oluşturulamaz
Hizmet

*Bu içerik, yapay zekâ (beta) kullanılarak çevrildi ve hatalar içerebilir. Sayfayı İngilizce görüntülemek için buraya tıkla.


Özet
Yöntemler
GenerateItemListAsync(generateRecommendationItemListRequest: Dictionary):RecommendationPages
LogActionEvent(actionType: Enum.RecommendationActionType,itemId: string,tracingId: string,actionEventDetails: Dictionary):()
LogImpressionEvent(impressionType: Enum.RecommendationImpressionType,itemId: string,tracingId: string,impressionEventDetails: Dictionary):()
RegisterItemAsync(player: Player,registerRecommendationItemsRequest: Dictionary):Dictionary
UpdateItemAsync(updateRecommendationItemRequest: Dictionary):()
Devralınan Üyeler

API Referansı
Yöntemler
GenerateItemListAsync
Bekletir
Capabilities: Basic
RecommendationService:GenerateItemListAsync(generateRecommendationItemListRequest:Dictionary):RecommendationPages
Parametreler
generateRecommendationItemListRequest:Dictionary
Kod Örnekleri
Önerilen öğelerin listesini oluştur
local RecommendationService = game:GetService("RecommendationService")
-- Öneri listesi oluşturma isteğini tanımlayın
local request: GenerateRecommendationItemListRequest = {
ConfigName = "MaximizeEngagement",
LocationId = "Lobby",
PageSize = 10
-- NOT: Sunucu scripti için CustomContexts.UserId'yi açın ve ayarlayın.
-- Yerel script için ayarlamaya gerek yok.
-- CustomContexts = {
-- ["UserId"] = tostring(player.UserId),
-- }
}
-- Öneri sayfalarını almak için GenerateItemListAsync'ı çağırın
local success, recommendationPages = pcall(function()
return RecommendationService:GenerateItemListAsync(request)
end)

GetRecommendationItemAsync
Bekletir
Capabilities: Basic
RecommendationService:GetRecommendationItemAsync(itemId:string):Dictionary
Parametreler
itemId:string
Dönüşler
Kod Örnekleri
Tek bir öneri öğesi al
local RecommendationService = game:GetService("RecommendationService")
local function getItem(itemId)
local success, item = pcall(function()
return RecommendationService:GetRecommendationItemAsync(itemId)
end)
if success and item then
print("Başarıyla öğe alındı: " .. item.ItemId)
print(" ReferenceId: " .. item.ReferenceId)
-- Tek bir öğe doğrudan alındığında TracingId boş olacaktır
if item.Creator then
print(" CreatorId: " .. tostring(item.Creator.CreatorId))
end
if item.CustomTags then
print(" Özel Etiketler: ")
for _, customTag in ipairs(item.CustomTags) do
print(" " .. customTag)
end
end
else
warn("Öğe alımında hata: " .. itemId .. ". Hata: " .. tostring(item))
end
end
-- Örnek kullanım (geçerli bir itemId gerektirir)
-- getItem("some-item-id")

LogActionEvent
Capabilities: Basic
RecommendationService:LogActionEvent(
actionType:Enum.RecommendationActionType, itemId:string, tracingId:string, actionEventDetails:Dictionary
):()
Parametreler
itemId:string
tracingId:string
actionEventDetails:Dictionary
Varsayılan değer: "nil"
Dönüşler
()
Kod Örnekleri
Bir kullanıcı eylemini kaydetme
local RecommendationService = game:GetService("RecommendationService")
local function logLike(itemId, tracingId)
local detail: RecommendationActionEventDetails = {
ReactionType = "Beğen",
Weight = 1.0
}
RecommendationService:LogActionEvent(Enum.RecommendationActionType.AddReaction, itemId, tracingId, detail)
print("Öğe için 'Beğen' eylemi kaydedildi: " .. itemId)
end
-- Örnek kullanım (GenerateItemListAsync'tan geçerli bir itemId ve tracingId gerektirir)
-- logLike("item-id", "tracing-id")

LogImpressionEvent
Capabilities: Basic
RecommendationService:LogImpressionEvent(
impressionType:Enum.RecommendationImpressionType, itemId:string, tracingId:string, impressionEventDetails:Dictionary
):()
Parametreler
itemId:string
tracingId:string
impressionEventDetails:Dictionary
Varsayılan değer: "nil"
Dönüşler
()
Kod Örnekleri
Bir kullanıcının izlenimini kaydet
local RecommendationService = game:GetService("RecommendationService")
local function logView(itemId, tracingId)
local detail: RecommendationImpressionEventDetails = {
Duration = 5, -- Kullanıcı 5 saniye görüntüledi
ItemPosition = 1,
DepartureIntent = Enum.RecommendationDepartureIntent.Neutral
}
RecommendationService:LogImpressionEvent(Enum.RecommendationImpressionType.View, itemId, tracingId, detail)
print("'Görüntüleme' izlenimi kaydedildi öğe: " .. itemId)
end
-- Örnek kullanım (GenerateItemListAsync'tan geçerli bir itemId ve tracingId gerektirir)
-- logView("some-item-id", "some-tracing-id")

LogPreferenceEvent
Capabilities: Basic
RecommendationService:LogPreferenceEvent(
preferenceType:Enum.RecommendationPreferenceType, targetType:Enum.RecommendationPreferenceTargetType, targetId:string, tracingId:string, itemId:string
):()
Parametreler
targetId:string
tracingId:string
itemId:string
Dönüşler
()

RegisterItemAsync
Bekletir
Capabilities: Basic
RecommendationService:RegisterItemAsync(
player:Player, registerRecommendationItemsRequest:Dictionary
Parametreler
player:Player
registerRecommendationItemsRequest:Dictionary
Dönüşler
Kod Örnekleri
Yeni bir öğe kaydet
local RecommendationService = game:GetService("RecommendationService")
local storage = game:GetService("ReplicatedStorage")
-- ReplicatedStorage'da 'RegisterItemRemote' adında bir RemoteFunction olduğunu varsayalım
local registerItemRemote = storage.RegisterItemRemote
registerItemRemote.OnServerInvoke = function(player, refId)
local request: RegisterRecommendationItemRequest = {
ContentType = Enum.RecommendationItemContentType.Dynamic,
ReferenceId = refId,
Duration = 60,
Visibility = Enum.RecommendationItemVisibility.Public,
CustomTags = {"locale:en-us", "seasonal:summer"},
Attributes = {
{
AssetId = 123,
Description = "test video",
TrimStartTime = 0,
TrimEndTime = 10.5
}
}
}
local success, response = pcall(function()
return RecommendationService:RegisterItemAsync(player, request)
end)
if success and response then
print("Öğe başarıyla kaydedildi. ItemId: " .. response.ItemId)
return response.ItemId
else
warn("Öğeyi kaydetme başarısız oldu. Hata: " .. tostring(response))
return nil
end
end

RemoveItemAsync
Bekletir
Capabilities: Basic
RecommendationService:RemoveItemAsync(itemId:string):()
Parametreler
itemId:string
Dönüşler
()
Kod Örnekleri
Bir öğeyi kaldır
local RecommendationService = game:GetService("RecommendationService")
local function removeItem(itemId)
local success, err = pcall(function()
return RecommendationService:RemoveItemAsync(itemId)
end)
if success then
print("Başarıyla kaldırıldı öğe: " .. itemId)
else
warn("Öğeyi kaldırmada başarısız: " .. itemId .. ". Hata: " .. tostring(err))
end
end

UpdateItemAsync
Bekletir
Capabilities: Basic
RecommendationService:UpdateItemAsync(updateRecommendationItemRequest:Dictionary):()
Parametreler
updateRecommendationItemRequest:Dictionary
Dönüşler
()
Kod Örnekleri
Bir öğeyi güncelle
local RecommendationService = game:GetService("RecommendationService")
local function updateItem(itemId)
-- Yalnızca güncellemek istediğiniz alanları dahil edin
local request: UpdateRecommendationItemRequest = {
ItemId = itemId,
Visibility = Enum.RecommendationItemVisibility.Private,
-- NOT: bütün CustomTags listesi, bu yeni liste ile değiştirilecektir
CustomTags = {"updated-tag"}
}
local success, err = pcall(function()
return RecommendationService:UpdateItemAsync(request)
end)
if success then
print("Başarıyla güncellendi öğe: " .. itemId)
else
warn("Öğeyi güncellemede başarısız oldu: " .. itemId .. ". Hata: " .. tostring(err))
end
end
-- Örnek kullanım
-- updateItem("güncellenecek-bir-öğe-id'si")

©2026 Roblox Corporation. Roblox, the Roblox logo and Powering Imagination are among our registered and unregistered trademarks in the U.S. and other countries.