stingray.Trophies 네임스페이스 참조

설명

PlayStation 4에서 트로피 기능에 액세스하기 위한 인터페이스입니다.

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

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

기타 관련 참조 항목

PlayStation 4

함수

create_context ( user_id ) : integer ID가 user_id인 플레이어에 대한 트로피 컨텍스트를 생성합니다.

매개변수

user_id :

integer

플레이어 ID입니다.

반환하는 항목

integer

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

free ( id ) 지정된 ID의 작업을 위해 트로피 시스템이 계속 추적하고 있는 모든 데이터의 점유를 풀어줍니다.

매개변수

id :

integer

작업의 ID입니다.

반환하는 항목

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

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

remove_context ( user_id ) : integer ID가 user_id인 플레이어에 대한 트로피 컨텍스트를 제거합니다.

매개변수

user_id :

integer

플레이어 ID입니다.

반환하는 항목

integer

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

status ( id ) : integer 지정된 ID의 작업 상태를 반환합니다.

매개변수

id :

integer

쿼리할 작업의 ID입니다.

반환하는 항목

integer

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

기타 관련 참조 항목

	stingray.Trophies.create_context() stingray.Trophies.remove_context() stingray.Trophies.unlock()
	Status codes

unlock ( user_id, trophy_id ) : integer ID가 user_id인 플레이어에 대해 ID가 trophy_id인 트로피를 잠금 해제합니다.

매개변수

user_id :	integer	플레이어 ID입니다.
trophy_id :	integer	트로피의 ID입니다.

반환하는 항목

integer

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

예:

id = stingray.Trophies.unlock(stingray.Pad1.user_id(), 1)

상태 코드

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

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

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

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

UNKNOWN : integer ID가 생성되지 않았거나, 이미 점유가 풀린 상태입니다.