PolicyService 幫助您查詢基於年齡範圍、位置和平台類輸入的全球玩家政策遵守情況的信息。
概要
方法
決定使用者是否能在體驗內看到品牌項目資產。
根據地理定位、年齡群組和平台返回關於玩家的政策資訊。
屬性
方法
CanViewBrandProjectAsync
決定使用者是否能在體驗內看到品牌項目資產。這個方法讓你與品牌合作，只向品牌相容的觀眾顯示商業資產。
若要使用 CanViewBrandProjectAsync，您必須使用 Roblox 提供的品牌項目 ID。若要請求品牌項目 ID，請 聯繫我們。
您必須在服務器端的腳本上呼叫此方法並將其包裝在 pcall() 中。
參數
你正在嘗試將品牌項目展示給的 Player 對象。
由 Roblox 提供的品牌項目 ID 代表與品牌項目相關的所有資產。
返回
品牌項目是否可以顯示給特定使用者。
範例程式碼
You must call CanViewBrandProjectAsync from the server-side and then fire an event on the client. Calling this method from the client-side returns an error.
Server-side code sample
-- In ServerScriptService
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local PolicyService = game:GetService("PolicyService")
-- Pre-created RemoteEvent in ReplicatedStorage
local RemoteEvent = ReplicatedStorage:WaitForChild("RemoteEvent")
local brandedAsset = ReplicatedStorage:WaitForChild("BrandedAsset")
local defaultAsset = Instance.new("Part")
Players.PlayerAdded:Connect(function(player)
-- PolicyService:CanViewBrandProjectAsync can only be called from the Server
local success, canView = pcall(function()
return PolicyService:CanViewBrandProjectAsync(player, "BRP-0123456789")
end)
if success and canView then
RemoteEvent:FireClient(player, brandedAsset)
else
RemoteEvent:FireClient(player, defaultAsset)
end
end)Client-side code sample
-- In StarterPlayerScripts
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
-- Pre-created RemoteEvent in ReplicatedStorage
local RemoteEvent = ReplicatedStorage:WaitForChild("RemoteEvent")
RemoteEvent.OnClientEvent:Connect(function(partToLoad)
local clonedPart = partToLoad:Clone()
clonedPart.Parent = workspace
end)GetPolicyInfoForPlayerAsync
根據地理定位、年齡群組和平台返回關於玩家的政策信息。返回的字典結構如下：
| 名稱 |
|---|
例外
與任何异步呼叫一樣，此方法需要被包裝在 pcall() 並且正確處理錯誤。完整的可能錯誤訊息及其原因清單是：
| 訊息 |
|---|
也可以參考 LocalizationService:GetCountryRegionForPlayerAsync() ，它會根據玩家的客戶端 IP 地理定位返回國家/地區代碼字串。
參數
返回
包含請求玩家政策資訊的辭典；參見上面的辭典結構。
範例程式碼
This code sample gets policy information for the local player and warns if they cannot interact with paid random item generators.
Getting Policy Information for a Player
local PolicyService = game:GetService("PolicyService")
local Players = game:GetService("Players")
local player = Players.LocalPlayer
local success, result = pcall(function()
return PolicyService:GetPolicyInfoForPlayerAsync(player)
end)
if not success then
warn("PolicyService error: " .. result)
elseif result.ArePaidRandomItemsRestricted then
warn("Player cannot interact with paid random item generators")
end