GlobalDataStore

이 함수는 제공된 키의 최신 값과 하나의 DataStoreKeyInfo 인스턴스를 반환합니다. 키가 존재하지 않거나 최신 버전이 삭제된 경우 두 값 모두 nil 가 됩니다.

열은 첫 번째 읽음후 4초 동안 로컬에 캐시됩니다. GlobalDataStore:GetAsync() 내에서 4초 내에 호출하는 모든 수정은 캐시에서 값을 반환합니다. GlobalDataStore:SetAsync() 또는 GlobalDataStore:UpdateAsync() 에 대한 모든

가장 최근 버전과 같은 특정 버전을 가져오려면 DataStore:GetVersionAsync() 를 사용합니다.

매개 변수

반환

이 함수는 제공된 값으로 키의 값을 증가시킵니다(둘 다 정수여야 함).

OrderedDataStore 는 버전 관리를 지원하지 않으므로 OrderedDataStore 키에서 이 메서드를 호출하면 현재 값을 증가된 값으로 덮어씁니다. 이렇게 하면 이전 버전을 액세스할 수 없습니다.

매개 변수

반환

이 함수는 새 "tombstone" 버전의 키를 만들어 지정된 키를 삭제하면 삭제됩니다. 이 전에, 그것은 제거 호출 전에 키의 최신 버전을 반환합니다.

이 함수를 사용하여 키가 제거된 후 GlobalDataStore:GetAsync() 에 대한 호출은 키를 반환합니다 nil . 이 키의 이전 버전은 DataStore:ListVersionsAsync() 및 2> Class.DataStore:GetVersionAsync()2> 을 통해 액세스할 수 있습니다.

OrderedDataStore 는 버전 관리를 지원하지 않으므로 키에 RemoveAsync() 를 호출하면 영구적으로 삭제됩니다.

삭제된 개체는 30일 후에 영구적으로 삭제됩니다.

이전 값이 GlobalDataStore:RemoveAsync() 또는 DataStore:RemoveVersionAsync() 을 통해 이미 삭제되었다면 함수는 nil , 1> nil1> 값에 대해 4> Class.DataStoreKeyInfo4> 를 반환합니다.

매개 변수

반환

이 함수는 최신 값, UserIds 및 지정된 키에 대한 메타데이터를 설정합니다.

데이터 스토어의 값은 버전이 되므로 GlobalDataStore:SetAsync() 는 매번 호출할 때 새로운 버전을 만듭니다. 이전 버전은 DataStore:ListVersionsAsync() / DataStore:GetVersionAsync()를 통해 30일 동안 영구적으로 삭제됩니다.

OrderedDataStore 는 버전 관리를 지원하지 않으므로 OrderedDataStore 키에서 이 메서드를 호출하면 현재 값을 덮어쓰고 이전 버전을 액세스할 수 없게 합니다.

메타데이터 정의는 항상 값과 함께 업데이트되어야 하며, 현재 값에 변경 사항이 없더라도 현재 값이 손실될 수 있습니다.

데이터 저장소에 저장된 모든 문자열은 유효해야 합니다. UTF-8 . UTF-8에서 값이 127보다 큰 경우에만 다중 바이트 코드 포인트를 인코딩하기 위해 127을 사용하므로 127보다 큰 단위는 UTF-8이 아니며 Class.GlobalDataStore:

업데이트 대 설정

GlobalDataStore:SetAsync()는 특정 키의 빠른 업데이트에 가장 적합하며 쓰기 제한에 대해서만 계산됩니다. 그러나 두 서버가 동시에 같은 키를 설정하려고 시도하면 데이터 불

매개 변수

반환

이 함수는 데이터 저장소에서 키의 값과 메타데이터를 검색하고 콜백 함수를 통해 새로운 값을 결정하고 값을 변경하지 않고 작성 작업을 취소합니다. 콜백이 nil을 반환하면 작성 작업이 취소되고 값이 변경되지 않습니다.

업데이트가 성공하면 새로운 버전의 값이 생성되고 이전 버전은 DataStore:ListVersionsAsync() 및 DataStore:GetVersionAsync()를 통해 액세스할 수 있습니다.

OrderedDataStore 는 버전 관리를 지원하지 않으므로 OrderedDataStore 키에서 이 함수를 호출하면 현재 값을 덮어쓰고 이전 버전을 액세스할 수 없게 합니다.

다른 게임 서버가 키를 짧은 시간 간에 업데이트하고 키의 현재 값을 설정하는 경우 GlobalDataStore:UpdateAsync() 는 함수를 다시 호출하여 이전 호출의 결과를 무시하고 함수를 최대한 많이 호출하십시오

데이터 저장소에 저장된 모든 문자열은 유효해야 합니다. UTF-8 . UTF-8에서 값이 127보다 큰 경우에만 다중 바이트 코드 포인트를 인코딩하기 위해 127을 사용하므로 127보다 큰 단위는 UTF-8이 아니며 Class.GlobalDataStore:

업데이트 대 설정

GlobalDataStore:SetAsync()는 특정 키의 빠른 업데이트에 가장 적합하며 쓰기 제한에 대해서만 계산됩니다. 그러나 두 서버가 동시에 같은 키를 설정하려고 시도하면 데이터 불

콜백 함수

콜백 함수는 두 인수를 허용합니다.

• 업데이트 전에 키의 현재 값입니다.
• DataStoreKeyInfo

콜백 함수는 다음과 같은 세 가지 값을 반환합니다.

• 키에 설정할 새로운 값.
• 키와 연결할 UserIds 배열. DataStoreKeyInfo:GetUserIds() 는 기존 ID가 변경되지 않은 경우에만 반환되어야 하며, 그렇지 않으면 모든 기존 ID가 제거됩니다.
• 키와 함께 사용할 메타데이터가 있는 Lua 테이블. DataStoreKeyInfo:GetMetadata() 는 기존 메타데이터가 변경되지 않은 경우 반환되지 않아야 합니다. 그렇지 않으면 모든 기존 메타데이터가 지워집니다.

콜백이 대신 nil을 반환하면 현재 서버는 키를 업데이트하려는 시도를 중지합니다.

콜백 함수는 생성할 수 없으므로 Library.task.wait()와 같은 호출을 포함하지 마십시오.

매개 변수

반환