stingray.Score 네임스페이스 참조

설명

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

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

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

기타 관련 참조 항목

PlayStation 4

함수

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

매개변수

id :

integer

순위 작업의 ID입니다.

반환하는 항목

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

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

기타 관련 참조 항목

stingray.Score.get_ranking_by_range() stingray.Score.ranking_result()

get_ranking_by_np_id ( user_id, board, np_ids ) : integer stingray.Score.get_ranking_by_range()와 동일하지만 지정된 사용자 목록에 대한 순위를 가져옵니다.

매개변수

user_id :	integer	플레이어 ID입니다.
board :	integer	보드의 ID입니다.
np_ids :	string[]	검색할 사용자의 NP ID를 포함하고 있는 테이블입니다. [] 표기는 이 유형이 어레이임을 나타냅니다. 어레이는 구성원의 키가 순차적인 정수이며, 각 요소의 값이 표시된 유형의 인스턴스인 테이블입니다.

반환하는 항목

integer

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

get_ranking_by_range ( user_id, board, start, size ) : integer 서버에서 순위 시퀀스를 요청합니다.

매개변수

user_id :	integer	플레이어 ID입니다.
board :	integer	보드의 ID입니다.
start :	integer	가져와야 하는 첫 번째 점수 항목의 순위입니다. 최고 순위의 값이 1입니다. 0을 전달하면 오류가 발생합니다.
size :	integer	가져와야 하는 항목 수입니다. 100보다 작거나 같아야 합니다.

반환하는 항목

integer

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

작업이 완료되면 stingray.Score.ranking_result()를 호출하여 결과를 가져올 수 있습니다. 결과는 stingray.Score.free()를 호출할 때까지 사용할 수 있는 상태로 메모리를 소비합니다.

기타 관련 참조 항목

stingray.Score.get_ranking_by_np_id()

ranking_result ( id ) : ps4_score_ranking_results 순위 작업의 결과를 반환합니다.

매개변수

id :

integer

순위 작업의 ID입니다.

반환하는 항목

ps4_score_ranking_results

가져온 순위를 포함하고 있는 테이블입니다.

작업이 완료된 후, 그리고 해당 작업에 대해 stingray.Score.free()를 호출하기 전에만 이 함수를 호출할 수 있습니다.

기타 관련 참조 항목

	ps4_score_ranking_item ps4_score_ranking_results
	stingray.Score.get_ranking_by_range()

record ( user_id, board, score ) : integer 지정된 사용자의 점수를 보드에 기록합니다.

매개변수

user_id :	integer	플레이어 ID입니다.
board :	integer	보드의 ID입니다.
score :	number	기록할 점수입니다.

반환하는 항목

integer

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

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

매개변수

id :

integer

순위 작업의 ID입니다.

반환하는 항목

integer

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

기타 관련 참조 항목

	stingray.Score.get_ranking_by_np_id() stingray.Score.get_ranking_by_range() stingray.Score.record()
	Status codes

상태 코드

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

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

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

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

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