Tus - stingray.Tus 네임스페이스 참조 - Stingray Lua API 참조

stingray.Tus 네임스페이스 참조
함수 | 결과 형식 상수 | 상태 코드
모두 확장 | 모두 축소

설명

PlayStation 4에서 TUS(타이틀 유저 스토리지) 기능에 액세스하기 위한 인터페이스입니다.

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

비동기 작업은 작업 중 진행 상황을 가져오기 위한 status() 호출로 전달할 수 있는 ID를 반환합니다. 작업이 완료되면 free()를 호출하여 이 오브젝트에 사용되던 메모리의 점유를 풀어주어야 합니다. 그렇지 않으면 결국 게임을 실행하는 데 필요한 메모리가 부족해집니다.

함수

매개변수

target :

any

슬롯을 삭제하려는 대상입니다.

options :

integer[]

삭제할 슬롯입니다.

[] 표기는 이 유형이 어레이임을 나타냅니다. 어레이는 구성원의 키가 순차적인 정수이며, 각 요소의 값이 표시된 유형의 인스턴스인 테이블입니다.
반환하는 항목

integer

작업에 대한 ID로, stingray.Tus.status()에 전달하여 작업 진행 상황을 추적할 수 있습니다.

예를 들면 다음과 같습니다.

stingray.Tus.delete(target, slot_1, slot_2, ...)
매개변수

target :

any

데이터 슬롯을 삭제하려는 대상입니다.

options :

integer[]

삭제할 슬롯입니다.

[] 표기는 이 유형이 어레이임을 나타냅니다. 어레이는 구성원의 키가 순차적인 정수이며, 각 요소의 값이 표시된 유형의 인스턴스인 테이블입니다.
반환하는 항목

integer

작업에 대한 ID로, stingray.Tus.status()에 전달하여 작업 진행 상황을 추적할 수 있습니다.

예를 들면 다음과 같습니다.

stingray.Tus.delete_data(target, slot_1, slot_2, ...)
매개변수

id :

integer

메모리 점유를 풀어줄 작업의 ID입니다.

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

작업이 성공적으로 완료되었는지 여부에 관계없이 가져온 모든 ID에 대해 free()를 호출해야 합니다. 그렇지 않으면 결국 TUS 시스템을 실행하는 데 필요한 메모리가 부족해집니다.

매개변수

target :

any

값을 검색하려는 대상입니다.

options :

integer*

저장된 값을 가져올 슬롯입니다.

* 표기는 지정된 유형의 인스턴스가 0개 이상 있을 수 있음을 나타냅니다.
반환하는 항목

integer

stingray.Tus.status()에 전달하여 작업 진행 상황을 추적할 수 있는, 작업에 대한 ID를 반환합니다.

작업이 완료되면 stingray.Tus.has_get_result() 및 stingray.Tus.get_result()를 사용하여 작업 결과를 가져올 수 있습니다. 예를 들면 다음과 같습니다.

stingray.Tus.get(target, slot_1, slot_2, ...)
매개변수

target :

any

작업의 대상입니다.

slot :

integer

데이터를 검색하려는 슬롯입니다.

반환하는 항목

integer

작업에 대한 ID로, stingray.Tus.status()에 전달하여 작업 진행 상황을 추적할 수 있습니다.

매개변수

id :

integer

stingray.Tus.get_data() 작업의 ID입니다.

반환하는 항목

ps4_tus_slot_data

지정된 슬롯에 대해 검색된 데이터를 포함하고 있는 테이블입니다.

stingray.Tus.has_get_data_result()가 true를 반환할 때에만 호출하십시오.

매개변수

target :

any

작업의 대상입니다.

options :

integer[]

정보를 가져와야 하는 슬롯입니다.

[] 표기는 이 유형이 어레이임을 나타냅니다. 어레이는 구성원의 키가 순차적인 정수이며, 각 요소의 값이 표시된 유형의 인스턴스인 테이블입니다.
반환하는 항목

integer

작업에 대한 ID로, stingray.Tus.status()에 전달하여 작업 진행 상황을 추적할 수 있습니다.

예를 들면 다음과 같습니다.

stingray.Tus.get_info(target, slot_1, slot_2, ....)
매개변수

id :

integer

stingray.Tus.get_info() 작업의 ID입니다.

반환하는 항목

ps4_tus_slot_data

stingray.Tus.get_info() 호출에서 요청된, 각 슬롯에 대한 항목이 포함된 테이블입니다. 각 항목은 stingray.Tus.get_data_result()에 의해 반환된 ps4_tus_slot_data 테이블과 동일한 필드를 갖고 있지만 data 필드는 없습니다.

stingray.Tus.has_get_info_result()가 true를 반환할 때에만 호출하십시오.

매개변수

id :

integer

stingray.Tus.get() 작업의 ID입니다.

format :

integer

Tus.DETAILS 형식을 지정하는 경우 이 함수가 각각 지정된 슬롯에 대한 결과를 제공하는 테이블의 목록을 반환합니다.

반환하는 항목

ps4_tus_slot_data[]

각 슬롯에 대한 항목이 포함된 테이블의 목록입니다.

[] 표기는 이 유형이 어레이임을 나타냅니다. 어레이는 구성원의 키가 순차적인 정수이며, 각 요소의 값이 표시된 유형의 인스턴스인 테이블입니다.

stingray.Tus.has_get_result()가 true를 반환할 때에만 호출하십시오.

매개변수

id :

integer

stingray.Tus.get() 작업의 ID입니다.

format :

integer

Tus.JUST_VALUES 형식을 지정하는 경우 이 함수가 슬롯의 값을 Lua 스택에서 직접 반환합니다.

반환하는 항목

number*

슬롯의 값을 Lua 스택에서 직접 반환합니다. 슬롯에 값이 없으면 해당 슬롯에 대해서는 nil이 반환됩니다.

* 표기는 지정된 유형의 인스턴스가 0개 이상 있을 수 있음을 나타냅니다.

stingray.Tus.has_get_result()가 true를 반환할 때에만 호출하십시오.

매개변수

id :

integer

stingray.Tus.get_data() 작업의 ID입니다.

반환하는 항목

boolean

지정된 ID의 stingray.Tus.get_data() 작업에 대해 유용한 결과가 있다면 true를 반환합니다.

stingray.Tus.get_data_result()를 호출하여 결과를 검색할 수 있습니다.

매개변수

id :

integer

stingray.Tus.get_info() 작업의 ID입니다.

반환하는 항목

boolean

지정된 ID의 stingray.Tus.get_info() 작업에 대해 유용한 결과가 있다면 true를 반환합니다.

매개변수

id :

integer

stingray.Tus.get() 작업의 ID입니다.

반환하는 항목

boolean

stingray.Tus.get() 작업에 대해 유용한 결과가 있으면 true를 반환합니다.

stingray.Tus.get_result()를 호출하여 결과를 검색할 수 있습니다.

매개변수

target :

string?

값을 설정하려는 대상입니다. 대상은 nil(이 경우 첫 번째 로그인 사용자가 사용됨), 사용자에 대한 값을 설정하는 경우 SceNpId, 또는 가상 사용자에 대한 값을 설정하는 경우에는 SceNpTusVirtualUserId일 수 있습니다.

? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.

options :

any(integer, number)*

해당 값이 뒤에 오는 슬롯입니다.

any(...) 표기는 이 항목이 괄호 내에 표시되는 어떠한 유형의 인스턴스도 될 수 있다는 의미입니다.
* 표기는 지정된 유형의 인스턴스가 0개 이상 있을 수 있음을 나타냅니다.
반환하는 항목

integer

stingray.Tus.status()에 전달하여 작업 진행 상황을 추적할 수 있는, 작업에 대한 ID를 반환합니다.

예를 들면 다음과 같습니다.

stingray.Tus.set(target, slot_1, value_1, slot_2, value_2, ...)
매개변수

target :

any

작업의 대상입니다.

slot :

integer

데이터와 정보를 설정할 슬롯입니다.

data :

string

설정할 데이터입니다.

info :

string?

선택 사항입니다. 설정할 정보입니다.

? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.
반환하는 항목

integer

작업에 대한 ID로, stingray.Tus.status()에 전달하여 작업 진행 상황을 추적할 수 있습니다.

매개변수

id :

integer

작업의 ID입니다.

반환하는 항목

integer

지정된 ID의 작업 상태입니다. status code 상수 중 하나일 수 있습니다.

결과 형식 상수

[get_results()]를 호출할 때마다 이 값 중 하나를 전달함으로써 슬롯에 관해 검색하려는 정밀도 수준을 지정할 수 있습니다.

ps4_tus_slot_data
stingray.Tus.get_result()
stingray.Tus.get_result()

상태 코드

status() 호출에 의해 반환될 수 있습니다.

COMPLETED : integer

작업이 성공적으로 완료되었습니다.

ERROR : integer

작업 중 오류가 발생했습니다.

STARTED : integer

작업이 시작되었고, 아직 완료되지 않았습니다.

UNKNOWN : integer

ID가 생성되지 않았거나, 이미 점유가 풀린 상태입니다.
Please send us your comment about this page