Steam API

Game Maker Language リファレンス > 組み込み関数 用途別 > Steam API

Steam API †

Steamクライアント／サーバーのチェック †

• steam_initialised()：Steam APIが正しく初期化されているかどうかをチェックします
• steam_stats_ready()：Steam統計機能(Achivements and Statistics)が正しくセットアップされているかどうかをチェックします
• steam_is_overlay_enabled()：Steamオーバーレイ機能が有効かどうかチェックします
• steam_get_persona_name()：Steamユーザ名を取得できます
• steam_get_user_steam_id()：SteamユーザIDを取得します
• steam_is_user_logged_on()：Steamにログインしているかどうかを調べます

The Steam Overlay †

Steam Overlayは、ユーザーにSteamのインターフェイスを表示するようにさせることができる視覚的なディスプレイです。これは通常、キーの組み合わせを使用して、ユーザー自身で行われますが、あなたは以下の機能を使用して、ボタンまたはOverlayを表示するイベントをマップすることができるように、あなたのゲームの中からそれを行うことができます

• steam_activate_overlay()：ゲーム内でsteam overlayのインターフェースをアクティブにします
• steam_is_overlay_activated()：steam overlayがアクティブかどうかチェックします

Leaderboards †

Steam APIは自動的に順位が反映される永続的なリーダーボード（ランキング）をサポートしています。これらのリーダーボードはコミュニティのWebページ上で世界中ユーザー、フレンドを表示するために使用することができます。各ゲームは最大10000のリーダボードを持つことができ、プレイヤーのスコアを追加後、すぐに取り出すことができます。各リーダーボードはプレイヤー１人につき１つまでであることに注意してください。

各リーダーボードのエントリは名前、スコアとそのランキングが含まれています。新たなランキングエントリがユーザに対して作成されるとき、このデータが交換されます。

• steam_create_leaderboard()：新しいリーダーボードを作成します
• steam_upload_score()：スコアをSteamサーバーにアップロードします
• steam_download_scores()：リーダーボードのすべて、または部分的にスコアをダウンロードします
• steam_download_scores_around_user()：現在のユーザを中心としたスコアをダウンロードします
• steam_download_friends_scores()：現在のユーザのフレンドのスコアを取得します

Steam非同期イベント †

• Steam非同期イベントについて

Achievements and Statistics †

アチーブメント †

• steam_set_achievement()：プレイヤーにアチーブメントを授与します
• steam_get_achievement()：指定のアチーブメントを獲得しているかどうかチェックします
• steam_clear_achievement()：指定のアチーブメントを初期化(獲得していない状態に）します

statistic †

• steam_set_stat_int()：整数値のstatisticを設定します
• steam_set_stat_float()：float値のstatisticを設定します
• steam_set_stat_avg_rate()：statisticの平均値を設定します
• steam_get_stat_int()：指定のstatisticの整数値を取得します
• steam_get_stat_float()：指定のstatisticのfloat値を取得します
• steam_get_stat_avg_rate()：statisticの平均値を取得します

リセット †

• steam_reset_all_stats()：statisticsのすべての値をリセットします
• steam_reset_all_stats_achievements()：statisticの値と獲得したアチーブメントをすべてリセットします

Cloud Functions †

SteamCluudはあなたのゲームのための簡単で透過的なリモートファイルストレージシステムを提供しています。GameMaker:Studioを使用してディスクに書き込まれたすべてのファイルがゲームが終了した後Steamサーバーに複製されます。 ユーザーがコンピュータを変更した場合、ファイルは、ゲームは、適切な関数を使用してそれらを読み取ることでファイルにアクセスできることを意味し、ゲームを起動する前に、新しいコンピュータにダウンロードされます。 スチームクライアントは、ファイルが、ユーザがアクセスしている可能性のあるすべてのコンピュータ間で同期を維持していることを確実にする作業を行います。

注意：デフォルトでは、CloudがSteamworksに上のゲームのために有効になっていません。それはあなたがバイトおよびファイル·クォータを設定する必要がSteamworksにゲームの管理者の「Cloud」タブから、以前に有効にする必要があります。あなたはあなたのゲームにSteamworks構成を公開し、次回は、クラウドストレージを使用できるようになります。

有効・無効のチェック †

• steam_is_cloud_enabled_for_app()：現在のゲームにおいてクラウド・ストレージが有効かどうかチェックします
• steam_is_cloud_enabled_for_account()：現在のユーザのクラウド・ストレージが有効かどうかチェックします

クラウドのサイズ取得 †

• steam_get_quota_total()：Steamクラウドのゲームで使用可能なストレージ領域の総サイズを取得します
• steam_get_quota_free()：Steamクラウドにゲームで使用可能なクォータ（データサイズ）の残りがどれくらいかを取得します

ファイル存在チェック †

• steam_file_exists()：Steamクラウドに指定のファイルが存在するかどうかチェックします
• steam_file_size()：Steamクラウドにある指定のファイルのサイズを取得します
• steam_file_persisted()：指定のファイルがSteamクラウドで同期がとれているかどうかチェックします

ファイルの読み書き †

• steam_file_write()：Steamクラウドのストレージ上にあるファイルに文字列を書き込みます
• steam_file_write_file()：指定のローカルファイルをSteamクラウドにコピーします
• steam_file_read()：Steamクラウドにあるファイルを読み込みます
• steam_file_share()：指定のファイルをSteamクラウド上にアップロードするよう強制的に同期を取ります

ファイルの削除 †

• steam_file_delete()：Steamクラウド上の指定のファイルを削除します

User Content †

• steam_publish_workshop_file()：Steamワークショップに以前に同期されたファイルをアップロードします
• steam_is_screenshot_requested()：Steam APIを使用してスクリーンショット撮影キーを押したかどうかポーリングします
• steam_send_screenshot()：現在のユーザのSteamコミュニティプロフィールページにスクリーンショットをアップロードします

DLC †

Steamは無料と有料のダウンロードコンテンツ（DLC）の両方をサポートし、ダウンロード可能なコンテンツを持つゲームは、Steamクライアントからゲームのプロパティダイアログを通して見ることができるダウンロード可能なコンテンツと、ユーザのゲームリスト内の単一のアプリケーションとして表示されます。 以前に所有、ゲームの不可欠な一部となっているダウンロード可能なコンテンツは、ゲームをインストールした時に、Steamが自動的にコンテンツを更新します。

これは、すべてSteamサーバーによって処理され、任意のDLCの構成はSteamworksのコントロールパネルを介して行われていますが、いくつかの関数はGameMaker:Studioからチェックすることができます

• steam_user_owns_dlc()：指定のDLC（ダウンロードコンテンツ）を現在のユーザが所持しているかどうか確認します
• steam_user_installed_dlc()：現在のユーザが指定のDLC（ダウンロードコンテンツ）をインストール済みかどうかチェックします