stingray.Cloud 네임스페이스 참조

설명

Windows 플랫폼의 로드 및 저장 기능에 대한 인터페이스입니다.

이 오브젝트는 싱글톤(Cloud가 하나뿐임)이기 때문에 어떠한 Cloud 오브젝트도 함수로 전달할 필요가 없습니다. 모든 함수는 Cloud 싱글톤에서 작동합니다.

Cloud는 게임을 위한 간편하고 투명한 원격 파일 저장소를 제공합니다. 파일은 게임이 실행 중인 동안 디스크에 써지고, 게임 종료 후 Steam 백엔드에 복제됩니다. 사용자가 컴퓨터를 바꾸면 게임 실행 전 파일이 새 컴퓨터로 다운로드됩니다.

파일 이름의 네임스페이스가 플랫인 경우 아무 디렉토리도 사용 또는 생성되지 않습니다. 폴더 구조가 필요한 경우 파일 이름에 접두사를 붙여 해결할 수 있습니다. 모든 파일 이름은 대소문자를 구분하지 않습니다.

비동기 작업은 작업 중 진행률을 가져오는 데 사용되는 토큰 오브젝트를 반환합니다. 로드/저장 작업 중 사용되는 정보의 점유를 풀어주려면 이 오브젝트를 닫아야 합니다. 그렇지 않으면 결국 게임을 실행하는 데 필요한 메모리가 부족해집니다.

다음 데이터 유형을 저장할 수 있습니다.

• 문자열
• 숫자
• 부울
• 테이블
• Vector3
• Vector3Box
• Matrix4x4
• Matrix4x4Box

기타 관련 참조 항목

	stingray.CloudToken
	steam_cloud_progress
	Steam

함수

auto_load ( filename ) : stingray.CloudToken 클라우드의 지정된 파일에 이전에 저장했던 데이터를 로드하고, 진행률 및 결과를 위해 쿼리할 수 있는 토큰을 반환합니다.

매개변수

filename :

string

로드할 파일의 이름입니다.

반환하는 항목

stingray.CloudToken

progress() 호출을 통해 쿼리할 수 있는 토큰입니다.

(작업 진행률을 확인하고 나서) 메모리 점유를 풀어주려면 반환된 토큰에 대해 stingray.Cloud.close()를 호출해야 합니다. 그렇게 하지 않으면 메모리 누수로 이어집니다.

auto_save ( filename, data ) : stingray.CloudToken 클라우드의 지정된 파일에 지정된 데이터를 저장하고, 진행률을 위해 쿼리할 수 있는 토큰을 반환합니다.

매개변수

filename :	string	데이터를 저장할 파일의 이름입니다.
data :	any	저장할 데이터입니다.

반환하는 항목

stingray.CloudToken

progress() 호출을 통해 쿼리할 수 있는 토큰입니다.

(작업 진행률을 확인하고 나서) 메모리 점유를 풀어주려면 반환된 토큰에 대해 stingray.Cloud.close()를 호출해야 합니다. 그렇게 하지 않으면 메모리 누수로 이어집니다.

close ( token ) 지정된 토큰에 해당하는 클라우드 작업 요청을 모니터링하기 위해 엔진이 사용하던 메모리의 점유를 풀어줍니다.

매개변수

token :

stingray.CloudToken

닫으려는 토큰입니다.

반환하는 항목

이 함수는 아무 값도 반환하지 않습니다.

기타 관련 참조 항목

stingray.Cloud.auto_load() stingray.Cloud.auto_save()

delete ( filename ) : stingray.CloudToken 지정된 파일 이름을 클라우드에서 삭제합니다.

매개변수

filename :

string

삭제할 파일의 이름입니다.

반환하는 항목

stingray.CloudToken

progress() 호출을 통해 쿼리할 수 있는 토큰입니다.

사용자가 응용프로그램 인터페이스에서 파일을 명시적으로 삭제할 때 delete()를 사용합니다.

enabled ( ) : boolean Steam 클라우드가 게임에 대해 활성화되어 있는지 여부를 나타냅니다.

매개변수

이 함수는 어떠한 매개변수도 수용하지 않습니다.

반환하는 항목

boolean

Steam 클라우드가 게임에 대해 활성화되어 있으면 true를 반환합니다.

Steamworks의 'Game Admin' 페이지에서 설정할 수 있습니다.

참고: Cloud가 활성화되어 있지 않으면 로드 및 저장 작업이 작동하지 않습니다.

forget ( filename ) : stingray.CloudToken 지정된 파일 이름의 저장을 취소합니다.

매개변수

filename :

string

저장을 취소할 파일의 이름입니다.

반환하는 항목

stingray.CloudToken

progress() 호출을 통해 쿼리할 수 있는 토큰입니다.

오래 된 파일을 자동으로 삭제해 클라우드 서비스의 여유 메모리를 확보하려면 forget()을 사용합니다. 사용자가 파일을 명시적으로 삭제할 때에는 forget()을 사용하지 마십시오.

progress ( token ) : table 지정된 토큰으로 식별된 저장 또는 로드 작업의 현재 상태에 관한 정보를 검색합니다.

매개변수

token :

stingray.CloudToken

비동기 작업의 상태에 대한 액세스를 제공하는 클라우드 토큰입니다.

반환하는 항목

table

저장 또는 로드 작업에 관한 정보를 포함하고 있는 테이블입니다.

기타 관련 참조 항목

	stingray.CloudToken
	steam_cloud_progress
	stingray.Cloud.auto_load() stingray.Cloud.auto_save() stingray.Cloud.delete() stingray.Cloud.forget()