本記事は、サムザップ Advent Calendar 2022 の12/7の記事です。
はじめに
はじめまして、サムザップの北島です。
ゲーム会社で働いているだけあって、私はゲームが大好きです！
特にPCゲームが大好きなのですが、仕事が忙しい社会人はついつい積みゲーが増えがちですよね（ゲームを買っただけで満足してしまう...）。
自分はどのくらい積みゲーが溜まっているのか！？
それを把握するため、12/4の記事では、Steam Web APIを使った簡単なPHPプログラムを動かし、自分のSteamアカウントの積みゲー（プレイ時間が1時間以下のゲーム）の一覧を取得しました。
そして、その結果、91本もの積みゲーが溜まっているという状況が分かりました。
もうすぐ年末年始の休みが来ますが、さすがに91本は遊べません...
さて、いきなりですが、Steamのファミリーシェアリングという機能をご存知でしょうか？
ファミリーシェアリングを使うと、家族間でお互いのアカウントに所持しているゲームをプレイし合うことができます。
Steam ファミリーシェアリングとは
Steamのライブラリを最大5つのアカウントまで家族間で共有する機能です。
https://store.steampowered.com/promotion/familysharing?l=japanese
積みゲーが91本あるということで、とても自分だけでは遊びきれないと判断しましたww
そこで今回は、前回の記事で取得できるようになった積みゲーの情報を、Discord Botを使って家族がいるDiscordで発言させ、自分の代わりに積みゲーを遊んでもらうことを目指します。
自分で遊べないなら、せめて他の人に遊んでもらおう！w
discord-php のインストール
弊社では、サーバーサイドのプログラムは主にPHPを使っています。
慣れている言語ということで、前回に引き続き今回もPHPを使いたいと思います。
Discord Botの開発には、discord-phpを使います。
まず、composerがない方は、以下でインストールしてください。
$ brew install composer
実行後、インストールされたことを確認するためにcomposerのバージョンを確認しましょう。
$ composer -v
______
/ ____/___ ____ ___ ____ ____ ________ _____
/ / / __ \/ __ `__ \/ __ \/ __ \/ ___/ _ \/ ___/
/ /___/ /_/ / / / / / / /_/ / /_/ (__ ) __/ /
\____/\____/_/ /_/ /_/ .___/\____/____/\___/_/
/_/
Composer version 2.4.4 2022-10-27 14:39:29
次に、作業ディレクトリを作成します。
$ mkdir project
そして、作業ディレクトリの下にcomposer.jsonを作成します。
今回は、discord-phpを使いたいので、その記述をしています。
{
"require": {
"team-reflex/discord-php": "*"
}
}
記述が終わったら、最後に以下を実行します。
$ composer install
これで、無事にdiscord-phpがインストールされるはずです。
Discord Bot の準備
続いて、Discord側でBOTアカウントを作る必要があります。
下記から作ることが可能です。
「New Application」ボタンを押下し、名前を入力、規約に同意するチェックを入れ、「Create」ボタンを押します。
続いてメニューの「Bot」から、ICONの設定などをした上で、TOKENをコピーしておきます（後で使います）。
なお、「PUBLIC BOT」は公開するつもりがなければオフにしておくのが良さそうです。
最後に、メニューの「OAuth2 -> URL Generator」からSCOPES: boy 、 BOT PERMISSIONS: Read Messages/View Channels, Send Messages でURLを生成し、生成したURLにアクセスして作成したBOTを動かしたいDiscordサーバーに追加してください。
これで準備が整いました。
作成したプログラム
準備が整ったので、BOTのコードを書いていきます。
今回書いたコード配下です。
<?php
use Discord\Discord;
use Discord\Parts\Channel\Message;
use Discord\WebSockets\Event;
include __DIR__.'/vendor/autoload.php';
$token = "【Discord Bot のトークンを記載】";
function get_tsumige_info() {
$api_key = "【Steam Web API の APIキー を記載】";
$steam_id = "【Steam ID を記載】";
// 所持しているゲームの情報を取得
$data = json_decode(file_get_contents("http://api.steampowered.com/IPlayerService/GetOwnedGames/v0001/?" . http_build_query(array("key" => $api_key, "steamid" => $steam_id, "include_appinfo" => 1))), true);
// プレイ時間が60分以下のゲームを抽出
$result = "";
$count = 0;
foreach($data["response"]["games"] as $row) {
if($row["playtime_forever"] <= 60) {
$result = $result . $row["name"] . ": " . sprintf('%d時間 %d分', $row['playtime_forever'] / 60, $row['playtime_forever'] % 60) . "\n";
$count++;
}
}
$result = $result . "-------------------------------------------------------\n";
$result = $result . "積みゲーの数: " . $count . "\n";
$result = str_split($result, 2000);
return $result;
}
$discord = new Discord(['token' => $token]);
$discord->on('ready', function ($discord) use ($channel_id) {
echo "Botを起動しました。\n";
$botUser = $discord->user;
$discord->on('message', function ($message) use ($botUser) {
if (isset($message->mentions[$botUser->id])) {
$text_array = get_tsumige_info();
foreach($text_array as $row) {
$message->reply($row);
}
}
});
});
$discord->run();
get_tsumige_info() は、中身を少し変更しているものの、前回の記事で作成した、積みゲーの情報を取得する関数になります。
Discordは1回の発言が2000文字までなので、2000文字を超える場合は配列で分割するようにしています。
if (isset($message->mentions[$botUser->id])) の部分ですが、BOTにメンションがついた時に、get_tsumige_info() で取得した積みゲーの情報をBOTに発言させています。
結果
では、作成したプログラムを動かしてみましょう。
$ php discord_bot.php
・
・
・
DiscordPHP.INFO: client is ready [] []
Botを起動しました。
Botが起動したので、Discord上でBotにメンションを飛ばしてみます。
結果、下記画像の通り、BOTが反応し、積みゲーの情報を教えてくれました。
これを見たDiscordの家族が、私の積みゲーを代わりに遊んでくれることを願います！w
明日（アドベントカレンダー 12/8の記事）は @ozaki_shinya さんの記事になります、お楽しみに！！