自作プラグイン/steamapi
 |
SteamのAPIを利用して様々な情報を取得するプラグイン
| steamapi.inc.php | |
|---|---|
| 製作者 | kanateko |
| バージョン | 1.1.6 |
| 動作確認 | PukiWiki 1.5.4 - 1.5.4 |
| 最終更新 | 2022-07-10 |
Valveの提供する Steam Web API などを利用してゲームの概要やそのコミュニティの情報などを取得・表示することができるプラグイン。
v1.1.0時点でゲームの概要 (レビューやタグも含む) やニュース、実績といった情報を利用できる。取得した情報はサーバーにキャッシュしておき定期的に更新をチェックするので、情報を手動で更新する手間を省くことができる。
- AppIDで指定したゲームの様々な情報を表示する。
- ゲーム概要
- 対応言語、ユーザータグ (ジャンル) 、レビュースコアは個別にも呼び出し可能。
- Steamでセール中の場合価格表示に割引を反映させる。
- 未発売の場合は "近日登場" のラベルを表示する。
- DLCがある場合は (その一部を) 表示する。
- ニュース
- サムネイル付きで最大10個まで表示できる。
- 実績一覧
- 秘密の実績も表示可能。
- 秘密の実績の表示/非表示の切り替え機能あり。
- 個別に実績の説明文を書き換えることもできる。
- ゲーム概要
- 一定時間ごとに更新をチェックする。
- 更新間隔を変更したり強制的に更新させることもできる。
- 最終更新の表示/非表示を切替可能。
ダウンロード
このプラグインは現在公開されていません。
| 日付 | バージョン | 備考 |
|---|---|---|
| 2022-07-10 | 1.1.6 |
|
| 1.1.5 |
| |
| 2022-07-06 | 1.1.3 |
|
| 2022-07-05 | 1.1.2 |
|
| 1.1.0 |
| |
| 2022-07-04 | 1.0.3 |
|
| 1.0.2 |
| |
| 1.0.1 |
| |
| 2022-07-03 | 1.0.0 |
|
| 2022-07-02 | 0.9.4 |
|
| 0.9.3 |
| |
| 0.9.2 |
| |
| 0.9.1 |
| |
| 0.9.0 |
| |
| 2022-07-01 | 0.8.1 |
|
| 0.8.0 |
|
使用方法
#steamapi(<タイプ>,<AppID>[,オプション]){{
[オプション]
[オプション]
[オプション]
︙
}}
AppIDはストアURLの store.steampowered.com/app/****** ← この数字の部分
オプションの指定はカッコ内に書いてもマルチラインで書いてもいいが、長くなりがちなものはマルチラインで書いたほうが見やすくなる。
タイプ
必ず最初に指定する。
summary - 概要表示
指定したゲームの以下の情報を表示する。
- 名前
- 読み、ルビを追加可能 (後述) 。
- 発売日
- 早期アクセス開始日を追加可能 (後述) 。
- 未発売のゲームの場合は "近日登場" のラベルが表示される。
- 開発元
- パブリッシャー
- 価格
- セール中は割引率と割引後の価格も表示される。
- 日本語対応状況
- ユーザータグ (ジャンル)
- レビュースコア
- マウスオーバーで詳細な内訳が表示される。
- DLC
- DLCがない場合は項目自体が表示されない。
- 最大5つのDLCが表示され、それ以上ある場合はストアへのリンクが表示される。
- ストアリンク
- その他ストアへのリンクを追加可能 (後述) 。
- ruby = < 任意の文字列 >
- 名前の下にカッコ書きで読みなどを追加する。
- ea = < Y 年 m 月 d 日 >
- 早期アクセスの開始日と正式リリースにを分けて表示する。
- tag = < 文字列 > | < 文字列 > | ...
- タグを追加する。
- tagnum = < 数字 >''
- 初期状態で表示するタグの数を変更する。
- epic, ps, xbox, switch, android, ios = <URL>
- 他のストアへのリンクになったアイコンを表示する。
- < 任意の文字列 > = < 任意の文字列 >
- 独自の項目を追加する。右辺ではPukiWiki記法を使用可能。
以下のtags, reviews, languageはsummaryの一部として表示される。
個別に呼び出せるようにはなっているが基本的に使うことはない。
tags - ユーザータグ一覧
ユーザータグの一覧を表示する。
デフォルトでは最初の5個を表示し、残りは折りたたむ。
- tag = < 文字列 > | < 文字列 > | ...
- タグを追加する。
- num = < 数字 >
- 初期状態で表示するタグの数を変更する。
reviews - ユーザーレビュー
直近30日と全期間のレビュー評価を表示する。
各評価にマウスオーバーするとレビューの総数、好評数、不評数の詳細が表示される。
language - 対応言語
対応言語の一覧、もしくは日本語の対応状況を表示する。
- ja
- 日本語のみを表示する。
news - Steamニュース一覧
Steamコミュニティで公開されたゲームのニュースを表示する。
見た目はSteamストアでの表示をある程度再現している。
- num = < 1 ~ 10 >
- ニュースの表示数を変更する。指定しない場合は自動的に2。
achievements - 実績一覧
そのゲームの実績一覧とそれぞれグローバル取得率を表示する。サーチやソート機能付き。
実績の言語はゲーム側で対応していればデフォルトで日本語になる。
秘密の実績はデフォルトで表示するようになっているが、実績名の横にある目のアイコン () で表示/非表示を切り替えられる。
またはリストの上にある同アイコンのスライダーを使えば一括で表示/非表示を切替可能。
初期状態で非表示にしたい場合は後述のオプションで指定する。
実績の説明文を書き換えたい場合は各実績の右上に表示される鉛筆アイコン () から専用の編集画面を表示できる。
編集画面ではテキストエリアに入力された内容が下のプレビューにリアルタイムで反映される。
テキストエリアを空にした場合は元々の説明文が表示される。
テキストエリア内で改行した場合は保存時に&br;に変換され、編集時に自動的に改行に変換される。
"変更を保存"を押すと下図のように変更内容がマルチライン部分に追記される。
この際、マルチライン内の実績名の並びが実際の表示の並びと違っている場合、自動的に実際の並びに合わせてソートしてから保存する。
通常の編集画面からマルチライン部分を編集すれば一度に複数の実績を編集できる。
実績名や説明文に "=" を含む場合は両者を繋ぐ "=" の数を2つ以上に増やす。
- < 実績名 > = < 説明文 >
- 該当する実績名の説明文を書き換える。
- autolink
- 実績の説明文に含まれる既存のページ名をリンクに変換する。書き換えた説明文は対象外。
このオプションが有効な場合、通常の編集画面でプレビューせずにページの更新をすると、実績の表示が更新されないので注意。個別編集機能で更新した場合は問題なし。もしくは一度このオプションを外せば更新される。
- refer = < Steam64ID >
- 該当のゲームを所持している公開ユーザーのSteam64ID。特にエラーが表示されていなければ必要なし。
オプション (汎用)
全てのタイプで使用できるオプション。
- passage or nopassage
- 経過時間の表示/非表示。summaryとnewsのみデフォルトで表示。
- < 数字 > h
- 更新のチェック間隔を変更する。0h を指定してプレビューすればキャッシュを強制的に更新できる。
使用例
サンプルを練習用Wikiに置いておくので試してみたい方はそちらへ。
追加予定
- 要求スペック表とストアの詳細な説明文
- summaryで一緒に取ってきてるのでそのうち追加予定。
- プレイヤー数
- プレイ中の人数は公式のAPIで提供されているのでそのうち追加予定。
備考
- 自サイトの編集支援用に作成したもののため、独自の仕様が含まれていたりPHP8以上じゃないと動かないといった事情があるので今のところ公開予定は無い。
コメント
コメントはありません。 コメント/自作プラグイン/steamapi