DataStoreService

Xác định xem chức năng lưu trữ dữ liệu có nên tự động thử lại hay không.

DataStoreService không tôn trọng thuộc tính này vì lý do kỹ thuật đã vô hiệu hóa việc thử lại tự động.Do đó, bạn phải triển khai các hệ thống để thực hiện lại các hoạt động của riêng mình.Có thể tự động thử lại sẽ được bật lại trong tương lai.

Chức năng này tạo một DataStore instance với tên và phạm vi được cung cấp.Các cuộc gọi tiếp theo đến phương thức này với cùng tên/phạm vi sẽ trả về cùng một đối tượng.

Sử dụng tham số scope sẽ hạn chế các hoạt động đến phạm vi đó bằng cách tự động gán phạm vi cho các chìa khóa trong tất cả các hoạt động được thực hiện trên kho dữ liệu.Chức năng này cũng chấp nhận một ví dụ tùy chọn DataStoreOptions bao gồm các tùy chọn để bật AllScopes .Xem Kho dữ liệu để có chi tiết về phạm vi.

Tham Số

Lợi Nhuận

Chức năng này trả về mặc định GlobalDataStore .Nếu bạn muốn truy cập một kho lưu dữ liệu cụ thể có tên là **** thay vào đó, bạn nên sử dụng chức năng GetDataStore().

Lưu ý rằng DataStore được trả bởi chức năng này luôn luôn sử dụng phạm vi u . Xem Kho lưu trữ dữ liệu để có chi tiết về phạm vi.

Lợi Nhuận

local DataStoreService = game:GetService("DataStoreService")

local GlobalDataStore = DataStoreService:GetGlobalDataStore()

print(GlobalDataStore.Name)

Phương pháp này trả về một OrderedDataStore , tương tự như cách GetDataStore() thực hiện với GlobalDataStores .Các cuộc gọi tiếp theo đến phương thức này với cùng tên/phạm vi sẽ trả về cùng một đối tượng.

Tham Số

Lợi Nhuận

local DataStoreService = game:GetService("DataStoreService")
local pointsStore = DataStoreService:GetOrderedDataStore("Points")

local function printTopTenPlayers()
	local isAscending = false
	local pageSize = 10
	local pages = pointsStore:GetSortedAsync(isAscending, pageSize)
	local topTen = pages:GetCurrentPage()

	-- The data in 'topTen' is stored with the index being the index on the page
	-- For each item, 'data.key' is the key in the OrderedDataStore and 'data.value' is the value
	for rank, data in ipairs(topTen) do
		local name = data.key
		local points = data.value
		print(name .. " is ranked #" .. rank .. " with " .. points .. "points")
	end

	-- Potentially load the next page...
	--pages:AdvanceToNextPageAsync()
end

-- Create some data
pointsStore:SetAsync("Alex", 55)
pointsStore:SetAsync("Charley", 32)
pointsStore:SetAsync("Sydney", 68)

-- Display the top ten players
printTopTenPlayers()

Chức năng này trả về số lượng yêu cầu lưu trữ dữ liệu mà vị trí hiện tại có thể thực hiện dựa trên Enum.DataStoreRequestType đã cho.Bất kỳ yêu cầu nào vượt quá ngân sách này sẽ bị hạn chế.Theo dõi và điều chỉnh tần suất yêu cầu lưu trữ dữ liệu bằng cách sử dụng chức năng này được khuyến nghị.

Tham Số

Lợi Nhuận

local DataStoreService = game:GetService("DataStoreService")

local globalStore = DataStoreService:GetGlobalDataStore()

local function printBudget()
	local budget = DataStoreService:GetRequestBudgetForRequestType(Enum.DataStoreRequestType.SetIncrementAsync)
	print("Current set/increment budget:", budget)
end

for i = 1, 5 do
	local key = "key" .. i
	local success, err = pcall(function()
		globalStore:SetAsync(key, true)
	end)
	if success then
		printBudget()
	else
		print(err)
	end
end

Trả về một đối tượng DataStoreListingPages để liệt kê qua tất cả các kho dữ liệu trải nghiệmNó chấp nhận một tham số tùy chọn prefix để chỉ tìm các kho dữ liệu có tên bắt đầu với tiền tố cung cấp.

Chỉ các kho dữ liệu chứa ít nhất một đối tượng sẽ được liệt kê thông qua chức năng này.

Tham Số

Lợi Nhuận