XboxLive - stingray.XboxLive 네임스페이스 참조 - Stingray Lua API 참조
설명
Xbox One에서 사용자 및 기타 Xbox Live 기능에 액세스하기 위한 인터페이스입니다.
사용자 캐시
시스템에서 로컬 사용자에 대한 정보를 가져오려면 성능이 크게 저하될 수 있기 때문에 엔진은 사용자 정보를 내부 사용자 캐시에 저장합니다.
사용자 캐시는 시스템에서 제공하는 이벤트를 통해 업데이트됩니다. stingray.XboxLive.user_cache_changed()를 통해 사용자 캐시가 업데이트되었는지 확인할 수 있습니다.
stingray.XboxLive.users()를 사용하면 모든 로컬 사용자 목록을 가져올 수 있고, 또는 stingray.XboxLive.user_info()를 사용하여 단일 사용자에 대한 정보를 가져올 수 있습니다.
user_cached_info의 id 구성원은 콘솔에 대한 로컬 고유 식별자로서 대개 Lua 인터페이스에서 user_id를 가리킵니다.
기타 관련 참조 항목 
함수
 |
has_new_game_invite ( ) : boolean |
| 이 함수는 어떠한 매개변수도 수용하지 않습니다. |
boolean |
이 함수를 마지막으로 호출한 이후 사용자가 게임 초대를 수락한 경우 true를 반환합니다. 시작 시, 사용자가 초대를 수락하면서 게임을 실행한 경우 true가 됩니다. |
| |
last_game_invite ( ) : map(string, string)?게임 초대 수락 이벤트로부터 인수를 반환합니다.
|
| 이 함수는 어떠한 매개변수도 수용하지 않습니다. |
map(string, string)? |
게임 초대를 수락하면 초대에 대한 키-값 쌍을 반환하고, 그렇지 않으면 nil을 반환합니다. map(...) 표기는 그 안의 각 키는 첫 번째로 표시되는 유형의 인스턴스이고, 각 값은 두 번째로 표시되는 유형의 인스턴스인 테이블을 나타냅니다. ? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다. |
이 함수의 결과에 대한 자세한 내용은 XDK 설명서의 "How to: Join an MPSD Session from a Title Activation" 섹션에 나와 있습니다.
stingray.MultiplayerSession.invite_friends()를 사용하는 경우 이 맵에는 XDK 설명서의 초대 수락 목록과 일치하는 키를 가진 항목들이 포함됩니다.
반환되는 세션 핸들과 일치하는 세션에 대한 이름 및 세션 템플릿 이름을 가져오려면 stingray.Network.handle_to_description()을 사용하면 됩니다.
| |
num_users ( ) : integer |
| 이 함수는 어떠한 매개변수도 수용하지 않습니다. |
integer |
현재 사용자 캐시에 포함된 사용자 수를 반환합니다. |
| |
online_state ( ) : integer |
| 이 함수는 어떠한 매개변수도 수용하지 않습니다. |
integer |
콘솔의 현재 온라인 상태를 반환합니다. OnlineState 상수 중 하나일 수 있습니다. |
기타 관련 참조 항목
| |
show_account_picker ( user_index )지정된 사용자의 계정 선택기를 표시합니다.
|
user_index : | integer | 계정 선택기가 표시되어야 하는 사용자의 사용자 색인입니다. Pad1을 사용하는 사용자는 1, Pad2는 2를 사용하는 식입니다. |
| 이 함수는 아무 값도 반환하지 않습니다. |
사용자의 패드에 대한 user_id()가 nil을 반환하는 경우 이 함수를 사용하면 됩니다. 이는 해당 사용자의 경우 로그인한 계정이 없다는 의미입니다.
| |
users ( ) : user_cached_info*사용자 캐시에서 모든 로컬 사용자에 대한 정보를 가져옵니다.
|
| 이 함수는 어떠한 매개변수도 수용하지 않습니다. |
|
사용자 캐시의 모든 사용자를 반환하거나, 또는 사용자가 없는 경우 nil을 반환합니다. * 표기는 지정된 유형의 인스턴스가 0개 이상 있을 수 있음을 나타냅니다. |
사용자 캐시가 변경되었는지 여부를 확인하려면 stingray.XboxLive.user_cache_changed()를 사용합니다.
| |
user_cache_changed ( ) : boolean |
| 이 함수는 어떠한 매개변수도 수용하지 않습니다. |
boolean |
이 함수를 마지막으로 호출한 이후 사용자 캐시가 변경된 경우 true를 반환합니다. |
기타 관련 참조 항목
| |
user_info ( user_id ) : user_cached_info사용자 캐시에서 제공된 사용자에 대한 정보를 가져옵니다.
|