# カスタムのスプラッシュ画面を使用してリーダーを設定する

リーダーのデフォルトのスプラッシュ画面をカスタマイズします。

スプラッシュ画面は、リーダーが支払いを受け付ける準備ができると表示されるデフォルトの画面です。これらのリーダーには、次の 2 つの方法のいずれかでカスタムのスプラッシュ画面を設定できます。

- ダッシュボード内
- Configuration API を使用する

管理するすべてのリーダーに適用される、アカウントのデフォルトスプラッシュ画面を設定できます。また、個々の店舗にカスタムのスプラッシュ画面を設定することも可能です。この場合、アカウントレベルで設定されたスプラッシュ画面が上書きされます。カスタムのスプラッシュ画面が設定されていない店舗は、アカウントのデフォルトスプラッシュ画面を継承します。

# ダッシュボード

> This is a ダッシュボード for when dashboard-or-api is dashboard. View the full page at https://docs.stripe.com/terminal/fleet/splash-screen?dashboard-or-api=dashboard.

スプラッシュ画面を更新するには、変更対象の関連設定に移動して編集します。新しい設定を追加する場合は、まず新しい設定を作成します。

## 店舗の詳細ページから

1. [Terminal Locations](https://dashboard.stripe.com/terminal/locations) ページに移動します。
1. パスコードを変更したい特定の店舗をクリックします。
1. **ローカル設定** または **継承された設定** で、選択したリーダータイプの**スプラッシュ画面** 行の横にある編集アイコン (✏) をクリックします。
   - すべてのリーダータイプに単一のスプラッシュ画面をアップロードまたは適用することはできません。
1. リーダーに表示する画像をアップロードします。JPG と PNG の画像は 2MB 未満、GIF の画像は 4 MB 未満である必要があります。リーダーごとに固有のディスプレイ解像度があり、JPG または PNG の画像は寸法に合わせてトリミングする必要があります。GIF の画像は自動的に拡大縮小されます。
1. **完了**をクリックします。
1. 店舗の最終設定をレビューし、設定ドロワーで **変更を適用** をクリックして、設定変更を適用します。

## 店舗管理ページから

1. [店舗を管理する](https://dashboard.stripe.com/terminal/locations/manage)ページに移動します。
1. 変更する特定の店舗を探します。
1. オーバーフローメニュー (⋯) > **設定を編集**をクリックします。
1. **スプラッシュ画面**アイコンの横にある**編集**または**上書きする**をクリックします。
1. スプラッシュ画面を適用するリーダータイプを示すために、リーダータイプ (S700、S710、BBPOS WisePOS E など) を選択します。
   - すべてのリーダータイプに単一のスプラッシュ画面をアップロードまたは適用することはできません。
1. リーダーに表示する画像をアップロードします。JPG と PNG の画像は 2MB 未満、GIF の画像は 4 MB 未満である必要があります。リーダーごとに固有のディスプレイ解像度があり、JPG または PNG の画像は寸法に合わせてトリミングする必要があります。GIF の画像は自動的に拡大縮小されます。
1. **完了**をクリックします。
1. 設定ドロワーの**変更を適用する**をクリックして、設定変更を適用します。

> BBPOS WisePad 3 のスプラッシュ画面には PNG 画像のみを使用できます。ハードウェアの仕様により、BBPOS WisePad 3 のスプラッシュ画面の画像は自動的に白黒に変換され、位置も若干変更されます。

> 4 MB 未満の GIF ファイルは、アップロードが失敗する可能性があります。この場合は、手動でフレームを削除して、ファイルサイズをさらに減らします。アップロードが成功するまで、GIF のフレームカウントを 50% 減らします。

| リーダー            | 解像度 (幅 x 高さ) | GIF を受け付ける |
| --------------- | ------------ | ---------- |
| Stripe S700     | 1080 x 1920  | ✓ サポート対象   |
| Stripe S710     | 1080 x 1920  | ✓ サポート対象   |
| BBPOS WisePOS E | 720 x 1280   | ✓ サポート対象   |
| Verifone P400   | 320 x 480    | –          |
| BBPOS WisePad 3 | 320 x 240    | –          |

アップロードしたら、変更を保存して設定を適用します。[モバイルリーダー](https://docs.stripe.com/terminal/mobile-readers.md)の場合、スプラッシュ画面は Stripe Terminal SDK に接続すると更新されます。[スマートリーダー](https://docs.stripe.com/terminal/smart-readers.md)の場合、リーダーのスプラッシュ画面は 10 分以内に更新されます。


# API

> This is a API for when dashboard-or-api is api. View the full page at https://docs.stripe.com/terminal/fleet/splash-screen?dashboard-or-api=api.

Configuration API を使用して設定を指定し、Stripe Reader 700、Stripe Reader 710、BBPOS WisePOS E、BBPOS WisePad 3、または Verifone® P400 のカスタムスプラッシュ画面を設定します。

1. ファイルをアップロードします。
1. [Configuration (設定)](https://docs.stripe.com/api/terminal/configuration.md) オブジェクトを作成または更新します。

## ファイルをアップロードする

[ファイルのアップロード API](https://docs.stripe.com/file-upload.md) を使用して、リーダーに表示する画像をアップロードします。JPG と PNG の画像は 2MB 未満、GIF の画像は 4 MB 未満である必要があります。リーダーごとに固有のディスプレイ解像度があり、JPG または PNG の画像は寸法に合わせてトリミングする必要があります。GIF の画像は自動的に拡大縮小されます。

> 4 MB 未満の GIF ファイルは、アップロードが失敗する可能性があります。この場合は、手動でフレームを削除して、ファイルサイズをさらに減らします。アップロードが成功するまで、GIF のフレームカウントを 50% 減らします。

| リーダー            | 解像度 (幅 x 高さ) | GIF を受け付ける |
| --------------- | ------------ | ---------- |
| Stripe S700     | 1080 x 1920  | ✓ サポート対象   |
| Stripe S710     | 1080 x 1920  | ✓ サポート対象   |
| BBPOS WisePOS E | 720 x 1280   | ✓ サポート対象   |
| Verifone P400   | 320 x 480    | –          |
| BBPOS WisePad 3 | 320 x 240    | –          |

#### curl

```bash
curl https://files.stripe.com/v1/files \
  -u <<YOUR_SECRET_KEY>>: \
  -F "file"="@/path/to/a/file.jpg" \
  -F "purpose"="terminal_reader_splashscreen"
```

## Configuration オブジェクトを作成または更新する

[Configuration](https://docs.stripe.com/api/terminal/configuration.md) オブジェクトを使用し、指定のデバイスタイプにカスタムスプラッシュ画面を設定します。対応可能なデバイスタイプは、`stripe_s700`、`stripe_s710`、`bbpos_wisepos_e`、`bbpos_wisepad3`、`verifone_p400` です。

> Stripe は、アカウントのデフォルト構成を自動的にプロビジョニングます。オプションで別の設定の [Configuration](https://docs.stripe.com/api/terminal/configuration.md) オブジェクトを作成することも、次のステップに進んでデフォルトの設定をアカウント全体に適用することもできます。

[Configuration](https://docs.stripe.com/api/terminal/configuration.md) オブジェクトを作成するには、[create configuration](https://docs.stripe.com/api/terminal/configuration/create.md) リクエストを使用します。

```curl
curl https://api.stripe.com/v1/terminal/configurations \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "stripe_s700[splashscreen]=file_1KjBJdE7XUJuZdf0F6GgO9uY"
```

[Configuration](https://docs.stripe.com/api/terminal/configuration.md) オブジェクトを更新するには、[update configuration)](https://docs.stripe.com/api/terminal/configuration/update.md) リクエストを使用します。

```curl
curl https://api.stripe.com/v1/terminal/configurations/tmc_EjHtMwLT8HmATT \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "bbpos_wisepos_e[splashscreen]=file_1KjBJdE7XUJuZdf0F6GgO9uY"
```