월드 상품 관리 페이지에서 등록하기 버튼을 눌러 상품을 등록할 수 있어요.
(등록한 상품은 삭제할 수 없어요.)
상품 등록 화면에서 상품 정보를 입력 후, 등록 버튼을 눌러요.
상품 정보
상품명 / 상품설명 / 상품이미지 : 상품의 용도를 기입합니다. 혐오감, 성희롱을 유발하는 등의 내용은 사용이 불가하며, 예고 없이 운영진에 의해 삭제될 수 있어요
판매 금액 : 구매 시 필요한 크레딧(가격)
상품 종류
종류
기능
사용 예시
이용권(영구성)
일회성 구매 상품
(특전, 접근권)
이용권 상품은 반복 구매할 수 없어요.
스테이지2 해금 상품
소모품(비영구)
반복 구매 상품 (재화, 소모성)
코인 +200 상품
무기아이템 1번 상품
스킨 상품
부활권
경험치 부스터 상품
판매상태 : 최초 등록 시 비공개로 등록되며, 등록 후에 상태를 변경할 수 있어요
상품 ID : 상품 등록 완료 시 자동으로 생성되며, Script에서 기능 연결 시 사용해요
※주의 사항
상품 등록 완료 후 이미지, 판매 상태만 수정할 수 있어요
(상품명, 상품설명, 판매금액 종류는 등록 후에 수정이 불가해요)
등록한 상품 내용의 수정은 제한되니 입력한 정보를 잘 확인 후 저장해 주세요.
3 상품 상태 변경하기⚙️
등록한 상품의 상태를 변경하기 위해 상품 이름 영역을 클릭해요.
상품 상태를 변경 후 수정 버튼을 누르면 상품 상태가 변경돼요.
상태
기능
비공개
상품을 판매 목록에서 노출하지 않아요. (구매한 상품은 보존됩니다.)
공개
상품을 판매 목록에 노출해요.
4 스튜디오에서 상품 정보를 불러올 월드 ID 입력하기🏷️
스튜디오에서 파일 메뉴 - 스튜디오 설정을 열고, Developer 탭에서 인월드 상품용 테스트 월드 ID에 상품이 등록된 월드의 ID를 입력해요.
월드의 ID는 월드 페이지의 주소에서 마지막 번호나 상품 관리 페이지에서 각 상품 번호의 앞 글자로 알 수 있어요.
인월드 상품용 테스트 월드 ID를 입력한 다음, 적용 버튼을 눌러요.
※주의 사항
설정한 인월드 상품용 테스트 월드 ID 정보는 맵(RMO)에 저장되는 정보가 아니기 때문에, 스튜디오를 끄면 다시 입력해야 해요
5 스크립트 기능 구현🛠️
5-1 판매할 상품 정보 가져오기🎁
공개 상태의 상품을 스크립트에서 가져오는 방법이에요.
--클라이언트 스크립트에서
ProductList = nil -- 상품 정보를 가져올 변수
----------------------------------------------------------------------------------------
--특정 상품 정보 출력
local function PrintProductData(productData)
local productID = productData.ID --상품 ID
local productName = productData.Name --상품 이름
local productType = productData.ProductType --상품 종류
local productDesc = productData.Comment --상품 설명
local priceType = productData.PriceType --상품 가격 타입
local productPrice = productData.Price --상품 가격
local productImageURL = productData.ImageURL --상품 이미지
print("productID", productID, "productName", productName, "productDesc", productDesc)
if productType == Enum.ProductType.Ticket then
print("productType", "이용권")
elseif productType == Enum.ProductType.Expendables then
print("productType", "소모품")
end
if priceType == Enum.PriceType.DitoCredit then
print("priceType", "크레딧", "productPrice", productPrice)
end
print("productImageURL", productImageURL)
print("--------------------------------------------")
end
----------------------------------------------------------------------------------------
--모든 상품 정보 가져오기
--(GetProductList 함수는 OnEnterPlayer나 OnSpawnCharacter가 아닌 UI 활성화시 같은 특정 시점에서 호출해야 해요.)
--(활성화된 상품 수가 많으면 반환이 늦을 수 있어요.)
local function RefreshProductList(self)
ProductList = Marketplace:GetProductList()
print("공개 상태의 상품 수 : ", #ProductList)
for i = 1, #ProductList do
local productData = ProductList[i]
PrintProductData(productData)
end
end
Workspace.ShopUI.ShopOpenButton.OnPressEvent:Connect(RefreshProductList)
5-2 상품 구매 요청🛒
특정 상품(상품 ID)에 대한 구매 시도를 요청하는 방법이에요.
--클라이언트 스크립트에서
----------------------------------------------------------------------------------------
--상품 구매 버튼 클릭시 상품 ID로 구매를 요청해요.
local function ClickPurchaseButton(self)
local productID = productData.ID
--OpenConfirmPopup 함수로 특정 상품의 구매 창을 출력해요.
Marketplace:OpenConfirmPopup(productID)
end
productButton.OnPressEvent:Connect(ClickPurchaseButton)
5-3 상품 구매 결과 처리📢
구매가 발생했을 때, 어떻게 결과를 판단하는지에 대한 방법이에요.
--클라이언트 스크립트에서
----------------------------------------------------------------------------------------
--상품 구매 처리 후
local function BindDoneEvent(buyEventData, flag)
local player = LocalPlayer:GetRemotePlayer()
local productID = buyEventData.ID --구매 시도한 상품의 ID
--구매 성공시
if flag == 1 then
print(player.Name .. " " .. productID .. " 구매 성공!")
--실제 지급 처리는 Server에서
--충전 필요시
elseif flag == 2 then
print(player.Name .. " " .. productID .. " 충전 필요!")
--중복 구매 또는 기타 이유
elseif flag == 3 then
print(player.Name .. " " .. productID .. " 중복 또는 기타 사유로 구매 실패!")
end
end
Marketplace.OnBuyDoneEvent:Connect(BindDoneEvent)
--서버 스크립트에서
----------------------------------------------------------------------------------------
--상품 구매 처리 후
local function BindDoneEvent(player, buyEventData, flag)
local productID = buyEventData.ID --구매 시도한 상품의 ID
--구매 성공시
if flag == 1 then
print(player.Name .. " " .. productID .. " 구매 성공!")
--충전 필요시
elseif flag == 2 then
print(player.Name .. " " .. productID .. " 충전 필요!")
--중복 구매 또는 기타 이유
elseif flag == 3 then
print(player.Name .. " " .. productID .. " 중복 또는 기타 사유로 구매 실패!")
end
end
Marketplace.OnBuyDoneEvent:Connect(BindDoneEvent)
5-4 구매 성공한 상품의 지급 처리📩
구매 결과가 성공(1)일 때, 상품을 지급하는 방법이에요.
OnBuyDoneEvent 함수에서 결과가 성공으로 반환되었을 때, SaveUserProductData 함수로 반드시 지급을 처리해야 해요.
구매는 성공했지만 통신 장애 등으로 인해 지급이 처리되지 않은 경우, 구매 상품에 대해서 OnBuyDoneEvent 함수가 다시 호출돼요.
즉, 구매한 상품들은 SaveUserProductData 함수가 반드시 호출되어야 하고, 호출되지 않으면 플레이어가 접속할 때마다 미지급 상품에 대해 OnBuyDoneEvent가 다시 호출돼요.
--서버 스크립트에서
----------------------------------------------------------------------------------------
--상품 구매 처리 후
local function BindDoneEvent(player, buyEventData, flag)
local productID = buyEventData.ID --구매 시도한 상품의 ID
local playerID = player:GetPlayerID()
--구매 성공시
if flag == 1 then
print(player.Name .. " " .. productID .. " 구매 성공!")
-- 상품 번호 1234_1가 Coin 200개 구매 상품일 때
if productID = "1234_1" then
--'Coin' 상품에 대한 구매 처리
local saveKey = "Coin"
local addValue = 200
local saveValue = player.Coin + addValue
--지급 처리와 함께 유저데이터 저장을 처리해요.
Marketplace:SaveUserProductData(playerID, saveKey, saveValue, buyEventData)
player.Coin = saveValue
print(player.Name .. " " .. productID .. " 지급 처리 완료!")
end
end
end
Marketplace.OnBuyDoneEvent:Connect(BindDoneEvent)
----------------------------------------------------------------------------------------
--'Coin' 재화 불러오기
local function LoadPlayerData(player)
local playerID = player:GetPlayerID()
--유저 데이터 불러오기
local saveKey = "Coin"
local loadValue = Game:GetSavedUserGameData(playerID, saveKey)
--불러올 데이터가 없으면
if loadValue == nil then
loadValue = 0
Game:SaveUserGameData(playerID, saveKey, loadValue) --초기값 저장
end
player.Coin = loadValue
end
Game.OnEnterPlayer:Connect(LoadPlayerData)
6 미지급건에 대한 확인 방법🔍
구매자가 미지급건에 대한 문의를 했을 때, 지급 상태를 확인하는 방법이에요.
판매 관리 페이지에서 판매 내역 조회 항목을 찾은 다음, 상태를 미지급으로 변경하고 검색을 클릭해요.
미지급된 상품만 따로 확인할 수 있어요.
7 판매 내역 확인💰
월드 관리 페이지 - 판매 관리 탭에서 판매한 상품의 내역을 확인할 수 있어요.
판매 내역은 CSV 다운로드 버튼을 눌러 웹이 아닌 환경에서도 확인할 수 있어요.
8 샘플맵🥰
상품 목록 가져오기, 상품 지급 처리 등 인월드 상품과 관련된 기능과 UI 처리가 모두 구현된 샘플 맵이에요.