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 を返します。

? 表記は、このタイプが省略可能であることを示しています。ゼロ個または 1 個のインスタンスが存在します。
パラメータ

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 定数の 1 つに一致します。これが 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、または「a.b.c.d:port」(port は接続ポート)という形式の IPv4 ゲーム サーバ アドレスのいずれかです。

any(...) 表記は、この項目が括弧内に示されている任意のタイプのインスタンスであることを示しています。

extra_params :

string?

オプション。招待にその他の情報を追加する文字列パラメータ。Steam はこれをコマンド ラインでパラメータとして使用するため、文字列にスペースおよび引用符は使用しないでください。最大で 31 文字です。簡潔にしてください。

? 表記は、このタイプが省略可能であることを示しています。ゼロ個または 1 個のインスタンスが存在します。

password :

string?

オプション。パスワードは、ゲーム サーバへの招待専用です。

? 表記は、このタイプが省略可能であることを示しています。ゼロ個または 1 個のインスタンスが存在します。
戻り値
この関数は値を返しません。
パラメータ
この関数はパラメータを受け入れません。
戻り値

integer

招待タイプ。invite type 定数の 1 つに一致します。これが 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?

オプション。1 つまたは複数のカテゴリを表す値です。friend relation flags グループ内の任意の数の定数を加算してマスクを形成します。マスクが指定されていない場合、FRIEND_FLAG が使用されます。

? 表記は、このタイプが省略可能であることを示しています。ゼロ個または 1 個のインスタンスが存在します。
戻り値

integer

カテゴリ内の友人の数を返します。

この関数を呼び出した後で、id()を呼び出して指定されたカテゴリ内の友人の ID を取得できます。