通過 | 文件 - Roblox 創作者中心

通行證讓您向使用者收取一次性 Robux 費用，以獲得體驗內的特殊特權，例如進入限制區、體驗虛擬人偶物道具或永久強化。

對於玩家可能多次購買的物品，例如藥水、暫時能量提升或經驗貨幣，請參閱開發者產品。

創建通行特權證

在創建通行特權證之前，請確保您的體驗已發布並可在 Roblox 上訪問。

要創建通行特權證：

前往創作並選擇一個體驗。
前往盈利 > 通行证。
按一下創建一個通行證。
上傳圖像以顯示為通行證圖示。請確保圖像不超過 512x512 像素、不包含外部圓形邊界之外的重要細節，並使用 .jpg、.png 或 .bmp 格式。
輸入通行特權證的名稱和說明。
點擊創建通行證。

如果您想將通行證用作隨機獎勵，請查看隨機化虛擬物品政策。

取得通行證 ID

若要使用指令碼化，您需要一個通行證 ID。要取得通行證 ID：

前往盈利 > 通行证。
將鼠標懸停在通行證的縮略圖上，點擊 ⋯ 按鈕，然後從上下文選單中選擇複製資產ID 。

出售通行特權證

如果你使用價格最佳化，請確保將腳本放置在 LocalScript 內，以便使用者查看個人化通行證價格。

您可以以兩種方式出售通行證：

在你的體驗中
超出你的體驗

在你的體驗中

要在體驗內實裝並銷售通行證，請呼叫 MarketplaceService 功能。

使用 GetProductInfo() 來取回關於通行特權證的資訊，例如名稱和價格，然後向使用者顯示該通行證。您可以在體驗市場內出售通行證，例如。對於通行證，第二個參數必須為 Enum.InfoType.GamePass 。


local MarketplaceService = game:GetService("MarketplaceService")

-- 將暫時器 ID 替換為您的通行證 ID
local productId = 000000

local success, productInfo = pcall(function()
	return MarketplaceService:GetProductInfo(productId, Enum.InfoType.GamePass)
end)


if success and productInfo then
	-- 檢查產品是否待買賣
	if productInfo.IsForSale then
	-- 顯示產品資訊
	-- 將列印聲明替換為使用者介面代碼以顯示通行特權證
  	print("Pass Name: " .. productInfo.Name)
  	print("Price in Robux: " .. productInfo.PriceInRobux)
  	print("Description: " .. productInfo.Description)
	else
		print("This product isn't for sale")
	end
end

使用 PromptPurchase() 來提示用戶購買通行證，如果用戶尚未在道具欄中擁有通行證。當使用者執行按下按鈕或與供應商 NPC 交談等動作時，您可以呼叫此功能。


local MarketplaceService = game:GetService("MarketplaceService")
local Players = game:GetService("Players")

-- 將暫時器 ID 替換為您的通行證 ID
local passID = 0000000

-- 快速購買通行證
local function promptPurchase()
	local player = Players.LocalPlayer
	local hasPass = false

	local success, message = pcall(function()
		hasPass = MarketplaceService:UserOwnsGamePassAsync(player.UserId, passID)
	end)

	if not success then
		warn("Error while checking if player has pass: " .. tostring(message))
		return
	end

	if hasPass then
		-- 顯示訊息告知使用者他們已擁有通行特權證
	else
		-- 快速購買通行證
		MarketplaceService:PromptGamePassPurchase(player, passID)
	end
end

使用 PromptGamePassPurchaseFinished() 來處理完成的通行證提示和購買，並為用戶分配與通行特權證相關的權限。

將腳本放置在 ServerScriptService 內，以便服務器處理用戶的通行權限。


local MarketplaceService = game:GetService("MarketplaceService")

-- 將暫時器 ID 替換為您的通行證 ID
local passID = 0000000  -- 將其變更為您的通行證 ID

-- 處理完成的提示和購買
local function onPromptPurchaseFinished(player, purchasedPassID, purchaseSuccess)
	if purchaseSuccess and purchasedPassID == passID then
		print(player.Name .. " purchased the Pass with ID " .. passID)
		-- 為使用者分配與通行證相關的能力或獎特權證
	end
end

-- 將提示遊戲通行證購買完成事件連接到函數
MarketplaceService.PromptGamePassPurchaseFinished:Connect(onPromptPurchaseFinished)

雖然 Roblox 本身不記錄特定使用者對開發者產品的購買歷史記錄，但您可以請求下載銷售數據。如果您想跟蹤特定用戶的購買歷史記錄，則您有責任儲存數據。

超出你的體驗

要在體驗詳情頁面的商店標籤上出售通行證：

前往盈利 > 通行证。
將鼠標懸停在通行證上，然後單擊 ⋯ 菜單。
選擇你想出售的通行證。
選擇銷售。
啟用到出售物品切換。
在 Robux 價格欄位中，輸入您想向使用者收費通行特權證的 Robux 數量。您輸入的價格會影響每次買賣售獲得的 Robux 數量。您輸入的價格會影響每次買賣售獲得的 Robux 數量。最低價格是 1 Robux，最高價格是 10 億 Robux。
點擊儲存變更。通行證會填充體驗細節頁面的儲存標籤。

分配通行證權限

您必須手動為購買您的通行證的使用者分配通行證權限。若要執行此操作，請在使用者加入您的體驗時使用 PlayerAdded 來檢查他們是否已擁有通行證，並為他們分配通行證權限。

將腳本放置在 ServerScriptService 內，以便服務器處理用戶的通行權限。


local MarketplaceService = game:GetService("MarketplaceService")
local Players = game:GetService("Players")

-- 將暫時器 ID 替換為您的通行證 ID
local passID = 0000000

local function onPlayerAdded(player)
	local hasPass = false

	-- 檢查用戶是否已擁有通行特權證
	local success, message = pcall(function()
		hasPass = MarketplaceService:UserOwnsGamePassAsync(player.UserId, passID)
	end)

	if not success then
		-- 發出警告並退出函數
		warn("Error while checking if player has pass: " .. tostring(message))
		return
	end

	if hasPass then
		-- 為使用者分配與通行證相關的能力或獎特權證
		print(player.Name .. " owns the Pass with ID " .. passID)
	end
end

-- 將玩家添加事件連接到函數
Players.PlayerAdded:Connect(onPlayerAdded)

通行分析

使用通行證分析來分析個人通行證的成功，識別趨勢，並預測未來可能的收入。

使用分析，您可以：

查看你在指定時間段內的最高通行證使用次數。
在時間序列圖上展示最多八個最熱門的產品，分析總銷售額和淨收入。
監控您的目錄並依銷售額和淨收入排序項目。

要存取通行證分析：

前往創作並選擇一個體驗。
前往盈利 > 通行证。
選擇分析標籤。

通過