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

설명

이 인터페이스는 Steam에서 친구를 처리합니다.

친구 정보

매개변수

id :

string

플레이어의 Steam ID입니다.

category :

integer

friend relations 그룹의 값입니다.

반환하는 항목

boolean

지정된 플레이어가 범주에 속하면 True, 그렇지 않으면 false입니다.

매개변수

id :

string

Steam ID입니다.

반환하는 항목

string

친구의 이름입니다.

매개변수

id :

string

플레이어의 Steam ID입니다.

반환하는 항목

steam_friend_game_info?

플레이어가 현재 플레이 중인 게임을 설명하는 테이블을 반환하거나, 친구가 게임을 플레이하고 있지 않으면 nil을 반환합니다.

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

id :

string

플레이어의 Steam ID입니다.

반환하는 항목

integer

friend relations 그룹의 값입니다.

매개변수

id :

string

플레이어의 Steam ID입니다.

반환하는 항목

integer

friend status 그룹의 값입니다.

친구 초대 유형

친구 관계

BLOCKED : integer

차단된 친구입니다.

FRIEND : integer

친구입니다.

IGNORED : integer

무시한 플레이어입니다.

IGNORED_FRIEND : integer

무시한 친구입니다.

NONE : integer

친구가 아닙니다.
친구를 요청하는 플레이어입니다.
친구 요청을 받았습니다.

SUGGESTED : integer

추천 친구입니다.

친구 관계 플래그

BLOCKED_FLAG = 1 : integer

차단된 친구입니다.

CLAN_MEMBER_FLAG = 8 : integer

클랜 멤버입니다.
친구 요청을 받았습니다.

IGNORED_FLAG = 256 : integer

무시한 플레이어입니다.

IGNORED_FRIEND_FLAG = 512 : integer

무시한 친구입니다.

ON_GAME_SERVER_FLAG = 16 : integer

게임 서버에 있는 플레이어입니다.
친구를 요청한 플레이어입니다.

REQUESTING_INFO_FLAG = 128 : integer

정보 요청 중입니다.

SUGGESTED_FLAG = 1024 : integer

추천 친구입니다.

친구 상태

AWAY : integer

자리 비움입니다.

BUSY : integer

다른 용무 중입니다.

LOOKING_TO_PLAY : integer

플레이 준비 중입니다.

OFFLINE : integer

오프라인입니다.

ONLINE : integer

온라인입니다.

SNOOZE : integer

휴식 중입니다.

TRADING : integer

거래 중입니다.

초대

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

integer

초대 유형입니다. invite type 상수 중 하나와 일치합니다. 이 값이 NO_INVITE인 경우 초대를 받지 않은 것입니다.

string

접속할 게임 주소입니다.

  • 초대 유형이 INVITE_LOBBY인 경우 이 값이 참여할 로비의 로비 ID가됩니다.
  • 초대 유형이 INVITE_SERVER인 경우 이 값이 "a.b.c.d:port" 형식(여기에서 port는 접속 포트)의 게임 서버 주소가 됩니다.

이 경우 게임이 지정된 서버 또는 로비에 즉시 참여해야 합니다.

매개변수

id :

string

플레이어의 Steam ID입니다.

game :

any(stingray.SteamLobby, string)

플레이어가 연결해야 하는 게임입니다. SteamLobby 오브젝트, 로비 ID 또는 IPv4 게임 서버 주소(형식: "a.b.c.d:port", 여기에서 port는 접속 포트)일 수 있습니다.

any(...) 표기는 이 항목이 괄호 내에 표시되는 어떠한 유형의 인스턴스도 될 수 있다는 의미입니다.

extra_params :

string?

선택 사항입니다. 초대에 추가 정보를 더하는 문자열 매개변수입니다. Steam은 이를 명령행에서 매개변수로 사용하기 때문에 문자열에 공백이나 인용 부호를 사용하면 안 됩니다. 최대 31자까지 가능합니다. 가능한 간단하게 만드십시오.

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

password :

string?

선택 사항입니다. 게임 서버 초대에만 해당하는 암호 문자열입니다.

? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.
반환하는 항목
이 함수는 아무 값도 반환하지 않습니다.
매개변수
이 함수는 어떠한 매개변수도 수용하지 않습니다.
반환하는 항목

integer

초대 유형입니다. invite type 상수 중 하나와 일치합니다. 이 값이 NO_INVITE인 경우 초대를 받지 않은 것입니다.

string

접속할 게임 주소입니다.

  • 초대 유형이 INVITE_LOBBY인 경우 이 값이 참여할 로비의 로비 ID가됩니다.
  • 초대 유형이 INVITE_SERVER인 경우 이 값이 "a.b.c.d:port" 형식(여기에서 port는 접속 포트)의 게임 서버 주소가 됩니다.

string

초대에 지정된 추가 매개변수의 문자열입니다.

string

초대 대상자: 초대를 받는 친구의 ID입니다.

해당하는 경우, 게임이 이 플레이어에게 지정된 서버 또는 로비에 참여할지 물어야 합니다. 이 과정이 제대로 이루어지려면 초대 대상자도 Presence.advertise_playing()을 호출해 초대 대상 로비 또는 서버를 표시해야 합니다. 그렇지 않으면 Steam 클라이언트의 초대가 제대로 작동하지 않습니다.

친구 목록

매개변수

index :

integer

마지막 Friends.num_friends() 호출을 통해 가져온 목록의 1기반 색인입니다.

반환하는 항목

string

지정된 색인에 있는 친구의 Steam ID입니다.

매개변수

category_mask :

integer?

선택 사항입니다. 하나 이상의 범주를 나타내는 값입니다. 그 수에 상관없이 모든 상수를 friend relation flags 그룹에 추가해 마스크를 형성합니다. 마스크가 지정되지 않으면 FRIEND_FLAG가 사용됩니다.

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

integer

범주에 속한 친구의 수를 반환합니다.

이 함수를 호출한 후에는 id()를 호출하여 지정된 범주에 속한 친구의 ID를 가져올 수 있습니다.