> For the complete documentation index, see [llms.txt](/llms.txt)

# お知らせ・受信箱

運営からのお知らせや、アイテム付きメッセージをプレイヤーに届けます。




**このデモについて**

デモは匿名アカウントで自動的にログインします。このアカウントはショールームのすべてのデモで共有されるため、あるデモで手に入れたアイテムや通貨が別のデモにも反映されます。読み込みには少し時間がかかります。画面が小さい場合は新しいタブで開いてお試しください。

## 概要

運営からのお知らせと、コイン付きの贈り物を自分の受信箱へ届けて開封するデモです。届いたメッセージは **Your inbox** に未読として並び、開封すると既読に変わります。贈り物のメッセージを開封すると、添付された 100 コインが **Where the coins land** のウォレットに入金されます。

## 試し方

1. **An announcement you can have delivered** の **Deliver** を押すと、**Your inbox** に「Welcome to the GS2 inbox demo!」というメッセージが未読で届きます。押すたびに新しいメッセージが 1 通届きます。
1. **Your inbox** のメッセージの **Open** を押すと既読になり、ボタンの代わりに **Opened.** と表示されます。
1. **A gift with coins attached**（**Carries 100 coins.**）の **Deliver** を押すと、「A gift from the operator: 100 coins.」というメッセージが届きます。
1. 贈り物のメッセージの **Open** を押すと、**Where the coins land** の **Free balance** が 100 増えます。

このデモの **Deliver** はお知らせの受信操作ではなく、交換を使って毎回新しいメッセージを送ります。そのため何度押しても、押した回数だけメッセージが届きます。

## 使用している GS2 のサービス

- [GS2-Inbox](/ja/microservices/inbox/): GS2-Inbox がプレイヤーの受信箱とメッセージの既読状態を保持します。贈り物のメッセージには開封時の報酬として GS2-Money2 への入金が添付されており、開封するとその入金が実行されます。
- [GS2-Exchange](/ja/microservices/exchange/): GS2-Exchange の無料の交換レート 2 つが、**Deliver** ボタンでお知らせと贈り物のメッセージを GS2-Inbox へ送るトランザクションを定義します。受信箱のメッセージは 7 日で期限切れになります。
- [GS2-Money2](/ja/microservices/money2/): GS2-Money2 のウォレット（スロット 0）が、贈り物を開封したときに無償コイン 100 を受け取ります。

## GS2 Studio で使う

GS2 Studio のシンプルモードで **機能を追加** を開き、**お知らせ・受信箱** の **追加** を押すと、この機能を自分のプロジェクトに取り込めます。パッケージを直接指定する場合は **GitHub から追加** を選び、次のパッケージを指定します。

```text
https://github.com/gs2io/gs2-studio-package/tree/main/foundation-liveops-inbox/packages/foundation-liveops-inbox
```

- オーナー: `gs2io`
- リポジトリ: `gs2-studio-package`
- サブディレクトリ: `foundation-liveops-inbox/packages/foundation-liveops-inbox`

## ソースコード

- デモのプロジェクト: <https://github.com/gs2io/gs2-studio-package/tree/main/foundation-liveops-inbox/live-demo>
- 機能パッケージ: <https://github.com/gs2io/gs2-studio-package/tree/main/foundation-liveops-inbox>



