#はじめに

このページは、クラウドゲーミングで TapFun にゲームを提供するパブリッシャー・開発者向けの接続仕様書です。Windows 向け exe をクラウド上の Windows サーバーで実行し、プレイヤーのブラウザへストリーミング配信します。主にプレイ時間課金で、アセットの追加ダウンロードが無いタイトルに適しています。

ブラウザで動作するゲームを提供する場合は Web App 向けの仕様書 を参照してください。

#テストプレイまで

1. 実行可能な exe が格納された zip ファイルを提出いただきます。
2. テスト環境でのプレイ用のリンクをお送りしますので、手触りなどをお試しください。
3. 無料プレイ時間の終了後もテストされる場合は、エナジーやタイトルパスの購入が必要です。決済手段には「AmazonPay」を選択してください（テスト環境での決済方法）。

テストプレイの結果、大きな問題が無ければ以下に進みます。

#コミュニケーション手段の確立

• 基本はメールで行います。
• 必要に応じて、両社が参加する Slack コネクトチャネルを TapFun 側で発行します。
• Slack コネクトチャネルへの参加ができない場合は、御社のコミュニケーションツールへ参加させていただきます。

#Publisher Console へのログイン

exe のアップデートや各種設定は、テスト環境の Publisher Console（https://<TEST_HOST>/publisher）で行えます。担当者がログイン権限を付与しますので、ログインされる方のメールアドレスをお伝えください。

#リリース内容の調整

動作上の問題の解決の目処が立ちましたら、リリース時期や提供価格を調整します。

#開発中の問題発生時の対応

「操作が反応しない」「意図しない動作がある」といった問題が発生した際は、以下を添えてコミュニケーションチャネルでお知らせください。

• 問題が再現したアプリ名（テスト環境上に同一ゲームが複数ある場合は、アプリ ID など識別できる情報）
• 問題が発生したテスト環境の TapFun ユーザーアカウント（ゲスト状態でのみ発生する場合を除く）
• 発生状況が把握できるスクリーンショット
• スクリーンショットで不足する場合は、再現手順全体の録画
• 問題の再現手順

問題が正常な仕様に起因する場合、双方協議のうえで機能追加や変更を行う場合があります。

#提出する exe の要件

• ゲームエンジンは問いません。Windows で起動できる exe であれば対象です。実際に動くかどうかは、非公開のテスト環境で確認します（13 GB のタイトルでも動作実績があります）。
• インストール工程はありません。 zip を展開して exe を直接起動します。同梱のランタイムのインストーラー（Visual C++ 再頒布可能パッケージ、OpenAL など）は実行されないため、必要な DLL は exe と同じフォルダに置いて同梱してください。
• exe からファイルを絶対パスで参照しないでください。ローカル PC とクラウド上ではパスが異なります。相対パスを使ってください。
• Steam などのクライアントが無くても起動する必要があります。 Steamworks を使っている場合は、外したビルドにするか、初期化に失敗してもそのまま続行するようにしてください（Steam が無い環境では、初期化が失敗したり起動時に止まったりしがちです）。そのほかの SDK・DRM・ランチャーへの対応は不要です。
• 言語を Steam の設定から決めている場合、TapFun 上では検出できません。OS のロケール、同梱の設定ファイル、または Publisher Console の「exe 起動パラメータ」（タイトル全体に共通）で言語を指定してください。
• 検証には exe そのものが必要です。Steam キーでの検証はできません。
• zip のファイル名は、タイトルが分かる名前にしてください（例: MyGame_Demo.zip）。

#exe の調整作業

リリースに向けて、exe の調整を行っていただきます。

• セーブデータのディレクトリは 保存できるパス のいずれかである必要があります。該当していれば、そのディレクトリを TapFun までお伝えください。該当しない場合は exe 側の変更が必要です。レジストリは使用できません。
• ウィンドウで起動してしまう場合は、フルスクリーンで起動するようにしてください。
• ゲーム内の設定でフルスクリーンの切り替えが可能な場合は、切り替えできなくすることが望ましいです。
• ゲーム内でユーザーが任意にゲームを終了（＝ exe プロセスの終了）できる場合は、できないようにすることが望ましいです。
• ゲーム内の外部リンク（ストアページやクレジットの URL など）は、プレイヤーのブラウザではなくクラウド上で開こうとするため動作しません。外部の URL を開くときは openUrl を使ってください。
• 「セーブフォルダを開く」のように、Windows の別アプリやフォルダを開く機能は動作しません。表示しないようにしてください。
• 画面上のデバッグ表示は、提出前に消してください。

#テストからリリースまで

1. テスト環境で確認する: テスト環境では、Basic 認証の後に、ご自身で作成した TapFun アカウントでログインします（プレイにはログインが必要です）。Publisher Console のバージョン一覧の「このバージョンで起動」からも起動できます。
2. 本番環境で最終確認する: 本番の Publisher Console の権限は別途付与します。リリース前は非公開の状態で、本番でのテストプレイの方法で確認してください。
3. 公開する: 公開作業は TapFun が行います。公開時刻は 10:00〜17:00 の間で調整できます。

• exe を受け取ってから公開までの目安は約 1 か月です（クラウド環境の準備と、クラウド版での確認・調整を含みます）。
• Publisher Console には権限の区別がありません。ログインできる方は全員が同じ操作をできます。ログインできる方を追加する場合は、メールアドレスを TapFun にお知らせください。

#デバッグ

ゲーム実行ページの URL に次のパラメータを付けると、クライアント API のやり取りを確認できます。

#プレイヤーからの問い合わせ

• TapFun のプラットフォームに関する問い合わせ（ログイン、決済、起動できないなど）は TapFun が対応します。必要に応じて、プレイヤー ID を添えてパブリッシャー様に共有します。
• ゲームの内容に関する問い合わせは、パブリッシャー様の窓口へご案内します。問い合わせ窓口（フォームなど）をご用意いただき、TapFun にお知らせください。

#FAQ

Q. ゲーム画面をクリックするまで音が出ません。 A. ブラウザの制約による挙動（仕様）です。

Q. ゲームパッドが反応しません。 A. ゲーム画面をクリックした後に反応します。状況によってはクリックしなくても反応しますが、基本として最初にゲーム画面のクリックが必要です。

Q. iPhone でほかのアプリから戻ると、音が出なくなります。 A. 毎回ではありませんが、すべてのタイトルで起きることがあります。音が出ないまま一度ホーム画面に戻り、もう一度ブラウザに戻ると回復します。

#環境

#ホスト名

テスト環境のホスト名と Basic 認証の ID / パスワードは秘匿情報です。このドキュメントには記載していませんので、TapFun の担当者にお問い合わせください。コード例などの <TEST_HOST> はテスト環境のホスト名に置き換えてください。社外や公開の場（公開リポジトリ、公開チャンネルなど）には記載しないでください。

#テスト環境での決済方法

テスト環境でエナジーやタイトルパスを購入する際は、次のいずれかを使用してください。

• AmazonPay: 選択すると「マルチペイメントサービス テスト環境」に遷移します。「決済する」を選択すると決済できます。
• テスト用クレジットカード: 番号 4111111111111111、有効期限は未来の任意の年月、セキュリティコードは任意の 3 桁の数字。

#本番でのテストプレイ

リリース前のアプリにアクセスするには、Publisher Console の基本情報でメンテナンスモードを有効にし、「メンテナンス例外メールアドレス」にテストプレイするユーザーのメールアドレスを入力してください。

本番で購入を伴うテストを行う場合は、TapFun 側でアプリごとにテストプレイ用アカウントを登録します。このアカウントには対象アプリでのみ使える TapFun クレジットが付与されます。テストプレイ用アカウントの購入は即座に取り消され、売上から相殺されます。

#Publisher Console

#基本情報

#詳細情報（紹介ページ）

「詳細情報」タブでは、TapFun 上のゲーム紹介ページに表示する内容を編集します。

操作説明画像とスクリーンショット画像は、ドラッグで並べ替えられます。削除するときは、画像をクリックして削除マークを付けたあと、「追加アップロード & 順序を保存」を押すと反映されます。

#販売情報

「販売情報」は表示のみです。DLC 以外の変更は TapFun にご相談ください。

#DLC

• Publisher Console 上で、TapFun のウェブページで販売する DLC を管理します。
• タイトル利用パス販売時には、DLC は「タイトル利用パス同梱版」および「通常版購入後の単体 DLC」として販売されます。
• DLC の内容は YAML 形式で記述します。複数登録できます（数の制限はありませんが、複数登録する際は事前にご相談ください）。
• 購入済みの DLC がある場合、exe 起動時に --dlcs 識別子,識別子,... を引数に渡します（起動パラメータ）。

- name: Digital Deluxe Upgrade
  code: digital_deluxe_upgrade
  price: 3270
  bundlePrice: 2000
  archived: false
  description: |
    通常版を Digital Deluxe Upgrade 版にアップグレードします。
    ・コラボ衣装（6 着）
    ・撮影機能「フォトフレーム」（6 種）

#Steam

Steam のストアページがあるタイトルでは、PC 幅のプレイ画面に Steam ストアの購入ウィジェットを表示します。

#バイナリ更新方法

• 使用中のバージョンを含めて 5 つまでアップロードできます。使用中以外のバージョンは削除できます。
• アップロード後、バージョン一覧から「First Release」を選択してリリースします（リリース時のセッションの扱い）。
• アップロード済みのバージョンを選んでゲームを起動できます。
• 新しくアップロードしたバージョンを一度リリースするまで、追加のバージョンはアップロードできません。
• テスト環境・本番環境ともに同じ操作で更新できます。
• 「First Release」にしたバージョンが、プレイヤーが起動するバージョンになります。以前のバージョンを「First Release」にすれば、前のビルドに戻せます。
• アップロード後、使えるようになるまでに処理時間がかかります。目安は 1〜5 GB で 30 分以内です。複数のバージョンを同時にアップロードしないでください。
• アップロード後に状態が「失敗」になる場合があります。削除して再試行しても成功しない場合は TapFun までご連絡ください。

#リリース時のセッションの扱い

「バイナリ」タブの画面:

• zip の構造: zip の中に「folder」のフォルダがあり、その中に「exe」があるようにします（<folder>/<exe>）。
• アップロードできない場合の表示: 「失敗したバージョンを削除してください」「不要なバージョンを削除してください」（5 つに達している）「First Release 待ちのバージョンがあります」のいずれかが表示されたら、その指示に従ってください。
• ApplicationVersions: アップロード済みのバージョンの一覧です。バージョンごとに「First Release」（リリース）、「Revert Version」（以前のバージョンに戻す）、「削除」、「このバージョンで起動」を操作できます。
• ツール → セーブデータダウンロード: TapFun ユーザー ID を入力すると、そのプレイヤーのセーブデータをダウンロードできます（ゲーム終了から数分後に行ってください）。

#ゲームの起動

アプリ画面上部の「アプリページ」から、次のオプションを付けてゲームを起動できます（デバッグ）。リリース前のアプリには「非公開状態」と表示されます。

#そのほかのタブ

#クラウド実行環境

#動作概要【重要】

TapFun は「リモートデスクトップ方式」でゲームをサーバー内で起動し、ブラウザからリモート操作します。クラウドゲーミングの基盤には Tencent CAR を使用しています。

• クラウド上の Windows サーバー（Windows Server 2019 / 2022）で exe を実行します。
• デスクトップ画面のグラフィックとオーディオ出力をキャプチャし、ブラウザ（tapfun.co.jp）内の canvas 要素へストリーミングします。ゲーム画面はフルスクリーンで起動してください。
• canvas 内のマウス操作・キーボード操作は Windows サーバー上の exe に送られます。
• ゲームの容量に制限はありません。
• 画面解像度は最大 1920x1080（既定）、リフレッシュレートは最大 60 fps です。解像度は Publisher Console の「デスクトップ横幅 / 高さ」で変更できます。
• Windows Media Foundation 経由で再生できる動画形式は H.264 / H.265 です。VP9 は使用できません。
• アセットの追加ダウンロードは通常行えません（ユーザー単位のデータとして保存されるため、容量次第でご相談になります）。
• Tencent CAR の各種機能・API の使用を希望される場合はご連絡ください。

#サーバー性能

#ネットワーク要件

ゲーム実行環境からゲームサーバーへ通信する場合の要件です。

• 受信の許可: すべての送信元から UDP 8000 および 60000〜60100 への受信を許可してください。
• すべての送信元を許可できない場合、テスト環境では次の IP のみ許可することで実行できます。 124.156.222.35, 124.156.224.128, 43.130.251.233, 43.133.176.140, 43.133.180.230, 43.133.218.250, 43.153.145.189, 43.153.153.36, 43.153.155.47, 43.153.157.78, 43.163.247.41, 150.109.195.27
• 接続元 IP: exe を実行するサーバーから外部へ HTTP 等で通信する際の接続元 IP は非公開です。

#ユーザーデータの保存復元

ユーザーデータは起動時に自動で復元され、終了時に自動で保存されます。

• 保存復元するディレクトリはゲームタイトルごとに設定でき、ディレクトリは 1 つ のみです。保存容量は合計 100 MB 以内 を推奨します。
• セーブデータは TapFun アカウントごとに保持され、ビルドを更新してもそのまま引き継がれます。
• クラウドストレージへの保存はゲーム終了後に行われます。Publisher Console からセーブデータをダウンロードする場合は、ゲーム終了から数分後に行ってください。
• 保存できるパスは次のいずれかの配下です。
  • C:\Users\%UserName%\AppData\Local\<任意のディレクトリ>
  • C:\Users\%UserName%\AppData\LocalLow\<任意のディレクトリ>
  • C:\Users\%UserName%\AppData\Roaming\<任意のディレクトリ>
  • <アップロードした zip のルートディレクトリ>\<任意のディレクトリ>
• exe と同じフォルダに直接置いたファイルは保存されません。exe と同じフォルダから 1 階層以上下のフォルダを作り、その中に保存してください。
• セーブデータディレクトリには、セーブデータ以外のファイルを入れないでください。 ディレクトリ内のファイルはすべてセーブデータとして保存・復元されます。DLL やアセットなどが入っていると、アップロードした zip の最新のファイルではなく、保存されていた古いファイルが復元され、不具合の原因になります。
• %UserName% は Windows のログインユーザー名です。ある程度固定的ですが基本的にランダムなため、参照は 1 セッション内に留めてください。
• 任意のディレクトリ名は TapFun までお知らせください。レジストリへの保存は復元されません。Unity の PlayerPrefs は Windows ではレジストリに保存されるため、ファイルに保存するよう変更してください。
• セーブデータを初期化する機能はありません。初回だけの動作（チュートリアルなど）は、別の TapFun アカウントで確認してください。
• 保存先の設定が終わるまでは、セーブの挙動は正しく動きません。セーブまわりの確認は、保存先の設定後に行ってください。

保存先の例:

#対応する入力

プレイヤーの操作は、クラウド上の Windows に次の入力として届きます。

• スマートフォン・タブレット（iOS / Android）からプレイできるのは、Publisher Console の「ゲームパッド対応」を有効にしたタイトルです。プレイヤーは画面上のバーチャルパッド（スティック・十字キー・各ボタン、Esc キーのボタン）またはタップで操作します。タップ操作だけで遊べるタイトルは、「ゲームパッド対応」を有効にし、「バーチャルパッドデフォルト」を無効にしてください。
• バーチャルパッドの入力はゲームパッドとして届くため、ゲーム側の追加の実装は不要です（Unreal Engine では、エンジンのゲームパッド設定がそのまま使えます）。
• スマートフォン・タブレットからはキーボード入力を送れません。キーを押さないと先に進めない場面（「A キーで開始」など）があると、スマートフォン・タブレットでは進めなくなります。タップかゲームパッドでも操作できるようにしてください。
• タッチ端末に仮想のマウスカーソルはありません。タッチはその位置へのマウスクリックとして届きます。2 本目以降の指（マルチタッチ）は区別できない場合があります。
• ゲームパッドの振動には対応していません。
• ゲームパッドとバーチャルパッドは、ゲーム画面を一度クリック（タップ）してから反応します（FAQ）。

#ゲームパッド

ほとんどの場合、そのままゲームパッドで操作できます。

#ワークアラウンド

ゲーム側で、入力を受け付けるゲームパッドを 1 台に絞ります。

1. 最初に入力（ボタンかスティック）があったゲームパッドを「担当」にし、それ以外のゲームパッドの入力は無視する。
2. 担当が切断されたら担当を解除し、次に入力があったゲームパッドを新しい担当にする。
3. 通常の PC でプレイヤーがパッドを持ち替えた場合に備えて、担当の入力が 1 秒ほど無いときだけ、ほかのゲームパッドの入力で担当を切り替える。

クラウド上の 2 台には数ミリ秒差で同じ入力が届くため、どちらが担当になっても操作は変わりません。パッドの種類や名前で判定しないので、通常の PC でも、基盤が修正されて 1 台に戻った後も、そのままで問題なく動きます。

#起動パラメータ

TapFun と API 連携するアプリに限り、exe の起動パラメータに --tapfun-user-id などを付与して起動します。既定では付与しません。 必要な場合は TapFun 担当者にご連絡ください（管理画面で有効にします）。付与しない場合、exe には Publisher Console の「exe 起動パラメータ」の値だけが渡ります。

C:\Apps\%UserName%\TapFunDebugConsoleApp.exe --type car --port 10100 --bearer-token 123_AAABBBCCC --api-host <TEST_HOST> --sig-key FFFGGGHHH --is-paid-timer 0 --is-sp 0 --tapfun-user-id PLYR01HE2R3JV6Y2NEGRMS4KZQB861DBG --dlcs delux_upgrade,special_upgrade --username=%E3%81%82%E3%81%84

#クライアント API

exe と、プレイヤーのブラウザ上の TapFun との通信用 API です。送信データは一旦ユーザーのブラウザを通るため、秘匿情報は含めないでください。

#通信仕様

送信は TapFun の HTTP API への POST、受信は exe 内での UDP 待ち受けです。送信には --tapfun-user-id と --bearer-token が必要です（起動パラメータ）。

送信

受信

#サンプル Unity プロジェクト

• GitHub: https://github.com/tapfuncojp/debug-console-app（閲覧には GitHub アカウント名が必要です。お知らせください）

送信のサンプル（Unity / C#）:

public IEnumerator SendCustomEventToCar(string userId, WWWForm formData)
{
    // config.apiHost = --api-host, config.bearerToken = --bearer-token
    string url = $"https://{config.apiHost}/api/v1/custom_event?userId={userId}";
    using (UnityWebRequest www = UnityWebRequest.Post(url, formData))
    {
        www.SetRequestHeader("Authorization", $"Bearer {config.bearerToken}");
        yield return www.SendWebRequest();
    }
}

受信のサンプル（Unity / C#）:

private UdpClient udpServer;
private IPEndPoint udpEndPoint;
private Thread serverThread;
private int udpServerPort = 10100; // --port
private bool isDataChannelReceiveLoopRunning = false;

public void CarHandleDataChannel()
{
    try
    {
        udpEndPoint = new IPEndPoint(IPAddress.Parse("127.0.0.1"), udpServerPort);
        udpServer = new UdpClient(udpEndPoint);
        isDataChannelReceiveLoopRunning = true;
        serverThread = new Thread(CarDataChannelReceiveLoop);
        serverThread.IsBackground = true;
        serverThread.Start();
    }
    catch (Exception e)
    {
        Debug.LogError($"Failed to start UDP server: {e.Message}");
    }
}

private void CarDataChannelReceiveLoop()
{
    while (isDataChannelReceiveLoopRunning)
    {
        try
        {
            byte[] receivedBytes = udpServer.Receive(ref udpEndPoint);
            string receivedMessage = Encoding.UTF8.GetString(receivedBytes); // クエリストリング形式
            byte[] responseBytes = Encoding.UTF8.GetBytes("OK");
            udpServer.Send(responseBytes, responseBytes.Length, udpEndPoint);
            lock (queueLock)
            {
                receivedMessagesQueue.Enqueue(receivedMessage);
            }
        }
        catch (Exception e)
        {
            Debug.LogError($"Unexpected error in receive loop: {e.Message}");
            Thread.Sleep(1000); // 予期しないエラーの場合は少し待ってから継続
        }
    }
}

#openUrl

指定した URL を別タブで開きます。

レスポンス通知: なし

#inputTextSingleLine

1 行の文字入力モーダルを表示します。

レスポンス通知:

#inputTextMultiLine

複数行の文字入力モーダルを表示します。

レスポンス通知: 入力が 128 文字を超える場合は、128 文字ずつのシーケンスに分割して複数回通知されます。

#inputTextMultiLineChunkText

inputTextMultiLine の初期テキストを分割して事前送信します。すべて送信した後に inputTextMultiLine を end 付きで送ると、分割した文字列を結合してモーダルを開きます。長いテキストを分けて送りたい場合に使用します。

レスポンス通知: なし

#copyText

テキストをクリップボードにコピーできるモーダルを表示します。

レスポンス通知: なし

#showText

テキストモーダルを表示します。

レスポンス通知: なし

#getPlayerEnvironment

プレイヤーの環境を取得します。

レスポンス通知:

#launchSuccessNotice

起動成功をプラットフォームに通知します。送信すると「ストリーミングを開始しています」のダイアログを早めに消せます。

起動成功通知待ちが有効なアプリでは、この通知を受信するか一定以上のストリーミングが持続するまで、マウス操作を受け付けません（プロセス起動完了前のマウス操作で応答待ちが発生するのを避けるため）。操作できない間はタイマーを消費しません。対象のアプリかどうかは事前にお伝えします。

レスポンス通知: なし

#consoleLog

ログを出力します。ゲーム実行ページの URL に ?verbose=1 を付けるとブラウザのデベロッパーツールのコンソールに、?debugLog=1 を付けると画面上のログ表示領域に表示されます（デバッグ）。

レスポンス通知: なし

#clientStatus

クライアント側の状態変化を通知します（リクエスト不要、自動送信）。

すべての通知に req=clientStatus が付きます。例: req=clientStatus&result=lastTimeRemain&second=90

#Web API

パブリッシャー様のサーバー、または exe から呼び出す HTTP API です。

#共通仕様

#認証

HTTP ヘッダー Authorization: Bearer <アプリID>_<APIキー>（Publisher Console の Bearer token）で認証します。

Authorization: Bearer 123_NWU0MjlkY2ViYTVkOTdiYjIwNThmZTkxMDMzYWM4Y2JmNGUyMTQ0Ng

認証失敗時は HTTP 403 で次を返します。

{"error":"no authorization"}

#POST /api/v1/photos

TapFun フォトストレージに画像を保存します。ユーザーは TapFun 上で、ゲームから保存された画像を閲覧・ダウンロードできます。認証: 必要。

制約:

• 最大保存枚数: 1,000 枚（超えた場合は古いものから自動削除）
• 最大容量: 1 枚あたり 10 MB（全体の容量制限はありません）
• 最大の高さ・幅: 12,000 ピクセル
• 最大画像サイズ: 100M ピクセル（例: 10,000 × 10,000）
• 連続呼び出しの待機時間・呼び出し回数の制限: なし

curl -F "file=@sample.jpg;type=image/jpeg" \
  -H "Authorization: Bearer 1_8an4dAfsIyEEvBbaKxd55P2Wgf" \
  "https://<TEST_HOST>/api/v1/photos?userId=PLYR01JY39A09EE40YQZRHWTT9EM1VDBG"

// 成功
{ "result": "success" }
// 失敗（404）: ユーザー ID が無い
{ "result": "failure", "message": "userId is not found" }
// 失敗（400）: その他（file が無い、大きすぎる、形式が不正など）
{ "result": "failure", "message": "other problems." }

#GET /api/v1/leaderboard/entries

リーダーボードのエントリー一覧を取得します。認証: 必要。

// 成功
{
  "result": "success",
  "entries": [
    {
      "position": 1,
      "userId": "PLYR01HE2R3JV6Y2NEGRMS4KZQB861DBG",
      "userName": "ユーザー名",          // UTF-8、絵文字不可、1〜12 文字
      "score": 12345,
      "note": "追加情報",                // 最大 8192 文字
      "createdAt": "2025-09-24T00:00:00.000Z",
      "updatedAt": "2025-09-24T00:00:00.000Z"
    }
  ]
}
// 失敗（404）: ユーザー ID が無い
{ "result": "failure", "message": "userId is not found" }
// 失敗（400）: その他
{ "result": "failure", "message": "other problems." }

#POST /api/v1/leaderboard/entries

リーダーボードのエントリーを作成・更新します。既存のスコア値以下（同値を含む）の場合は更新しません。リーダーボードは name ごとに自動で作られます。認証: 必要。

// 成功
{ "result": "success" }
// 失敗（404）: ユーザー ID が無い
{ "result": "failure", "message": "userId is not found" }
// 失敗（400）: その他
{ "result": "failure", "message": "other problems." }

#POST /api/v1/leaderboard/entries/delete

リーダーボードのエントリーを削除します。エントリーが無い場合も成功を返します。認証: 必要。

// 成功
{ "result": "success" }
// 失敗（404）: ユーザー ID が無い
{ "result": "failure", "message": "userId is not found" }
// 失敗（400）: その他
{ "result": "failure", "message": "other problems." }

#用語

#実行環境

exe を実行し配信するクラウドストリーミングサーバーです。

#TapFun ユーザー ID

• ユーザーを特定する最大 64 桁のユニーク ID です。アプリごとに発行されます。
• 文字種は 0-9, a-z, A-Z です。
• 形式は PLYR + ULID + アプリごとの suffix（3〜7 文字。例: DBG, XENO, MOCODVLP）です。

#アプリ ID

アプリを特定する unsigned int 型の ID です。

#API キー

アプリごとに発行される 26 桁の文字列です。文字種は 0-9, A-Z です。

#Publisher Console

パブリッシャー様向けの管理画面です。アプリの設定、紹介ページ、売上の確認などを行います。テスト環境と本番環境で別々にあり、ログインできる方は TapFun が登録します。

#紹介ページ

TapFun 上のゲームのページです（https://tapfun.co.jp/p/<アプリ>）。ゲームのプレイ画面は https://tapfun.co.jp/p/<アプリ>/play です。内容は Publisher Console の詳細情報で編集します。

#ゲスト

TapFun にログインしていない状態のプレイヤーです。

#TapFun ウォレット

プレイヤーが TapFun でチャージする残高です。TapFun 上での購入に使います。

#TapFun クレジット

本番環境のテストプレイ用アカウントに付与される、対象のアプリでのみ使えるウォレット残高です（本番でのテストプレイ）。

#セッション

クラウド上でゲームを起動してから終了するまでの 1 回分のプレイです。セッションの終了時にセーブデータが保存され、次のセッションの開始時に復元されます。

#お試し時間

タイトルごとに設定された、無料でプレイできる時間です（Publisher Console の「お試し分数」）。1 回分は 12 時間後に回復します。

#エナジー

プレイ時間を延長するためにプレイヤーが購入する単位です。エナジー 1 つで遊べる時間はタイトルごとに設定され、タイトル利用パスを持っているかどうかで別々の値になります（販売情報）。

#タイトル利用パス

タイトルごとに販売する利用権です（「タイトルパス」とも書きます）。購入後、設定された時間は無料でプレイできます。DLC を同梱した版も販売できます（DLC）。

#有料タイマーユーザー / 無料タイマーユーザー

有料のプレイ時間（エナジーやタイトル利用パスで得た残り時間）が 1 秒以上あるプレイヤーが有料タイマーユーザー、それ以外が無料タイマーユーザーです。起動パラメータ --is-paid-timer や getPlayerEnvironment の isPaidTimer で分かります。

#First Release

Publisher Console で、アップロード済みのバージョンを、プレイヤーが起動するバージョンにする操作です（リリース時のセッションの扱い）。

#バーチャルパッド

スマートフォン・タブレットのプレイ画面に表示する仮想のゲームパッドです。入力はゲームパッドの入力として exe に届きます（対応する入力）。

#変更履歴

↑ ページ先頭へ