チャットサービス
アプリケーションにチャットのウィジェットを貼ります。投稿されたメッセージは Mobage の通常のチャットと同様に審査が行われます。
このサービスを利用するには事前に RESTful API でチャットのチャンネルを生成する必要があります。
RESTful API に関する詳細は Chat API をご覧ください。
定義
要素名
mobage:embedChat
属性
| 名前 | 必須 | 説明 | デフォルト値 | 備考 |
|---|---|---|---|---|
| data-plugins-type | ○ | mbga-game-chat で固定値 | – | – |
| data-talk-id | ○ | チャットの生成済みチャンネル ID | – | – |
| data-product-name | ○ | タイトル名 | – | – |
| data-widget-id | 生成されるウィジェット要素 (iframe) への ID (DOMのid) | "game-chat" | – | |
| data-widget-mode | ウィジェットのモード | "simple_message_list" | "simple_message_list" / "message_list" / "preview" | |
| data-use-stream | リアルタイムチャット (true/false) | false | – | |
| data-limit | 表示するメッセージの最大数 | 5 | – | |
| data-preview-limit | プレビュー時に表示するメッセージの最大数 | 1 | data-widget-mode が "preview" の場合のみ有効 | |
| data-stamp-size | スタンプサイズ ("small"/"large") | "small" | data-widget-modeが "message-list" の場合のみ有効 | |
| data-theme | テーマ ("dark"/"light") | "light" | – | |
| data-default-message | 入力に表示するデフォルトメッセージ | – | – | |
| data-success-callback | メッセージ投稿が成功した場合のリダイレクト先URL | – | Gadget サーバ経由のURLへの置換されます | |
| data-show-header | ヘッダー部分の表示/非表示 (true/false) | true | – | |
| data-show-link | 下部ボタン部分の表示/非表示 (true/false) | true | – | |
| data-show-postform | 投稿の入力フォームの表示/非表示 (true/false) | true | – | |
| data-style-sheet | ゲーム独自のスタイルを定義した CSS ファイル | – | Gadget サーバ経由のURLへの置換されます |
ウィジェットのモード
simple_message_list モード
リスト形式でチャットメッセージが表示されるモードです。

message_list モード
吹き出し形式でチャットメッセージが表示され、履歴を見るボタンが配置されるモードです。

preview モード
最新メッセージのみを表示し、アコーディオン形式で開閉できるモードです。

HTML 構成と CSS クラス
ゲームチャットのウィジェットで使われている各パーツの HTML には、custom- の接頭辞で始まる class が与えられています。その class に CSS を適用させてカスタマイズすることができます。作成した CSS ファイルは、data-style-sheet 属性で指定します。
注記
カスタマイズのために、bodyに third というclass名が与えられているので、そこから継承して下さい。
custom-log-controller-area
<div class =" custom-log-controller-area ">
<div class =" custom-wrap-log-controller ">
<a class =" custom-log-controller-button "> 履歴を見る </a>
</div>
<div class =" custom-wrap-log-controller ">
<a class =" custom-log-controller-button "> 最新を見る <span class =" custom-latest-comment-num "> 99+ </span></a>
</div>
</div>
custom-open-chat-app-area
<div class =" custom-open-chat-app-area ">
<div class = " custom-open-chat-container ">
<a class =" custom-open-chat-app-button " href =" * " target =" _blank "> チャットで見る </a>
</div>
</div>
custom-header-area
<div class =" custom-header-area ">
<div class =" custom-header-container ">
<h1 class = " custom-header-title "> title </h1>
<span class =" custom-header-reload-button "></span>
</div>
</div>
custom-open-log-reload-area
<div class =" custom-open-log-reload-area ">
<a class =" custom-open-log-reload "> チャットエリアを更新 </a>
</div>
custom-preview-close-cell
<div class " custom-preview-close-cell ">
<a class= " custom-preview-close-button "> 閉じる </a>
</div>
custom-preview-open-cell
<div class =" custom-preview-open-cell ">
<a class =" custom-mocha-bt-morelink-down-icon "> 開く </a>
</div>
custom-post-form-area
<div class =" custom-post-form-area ">
<form action ="" method =" post ">
<a class =" custom-stamp-button "> スタンプ </a>
<span class =" custom-post-wrap ">
<input type =" text " value ="" class =" custom-post-text ">
</span>
<input type =" submit " value=" 送信 " class =" custom-submit-button ">
</form>
</div>
custom-preview-cell
<!-- 1 -->
<div class =" custom-preview-cell ">
<div class =" custom-preview-name ">ゆるふわ </div>
<div class =" custom-preview-msg ">レイドボス戦、支援ありがとうございます! </div>
</div>
<!-- /1 -->
<!-- 2 -->
<div class =" custom-preview-cell ">
<div class =" custom-preview-name "> ドンキー </div>
<div class =" custom-preview-msg "> 明日も1位目指して頑張りましょう♪ </div>
<div class =" custom-preview-time ">16:36 </div>
</div>
<!-- /2 -->
custom-messages-area
<div class =" custom-log-controller-area ">
<!-- メッセージがある時はolにcustom-messages-area-has-messagesのカスタムクラスを付ける。custom-messages-area-no-messagesは付かない。 -->
<!-- メッセージがない時はolにcustom-messages-area-no-messagesのカスタムクラスを付ける。custom-messages-area-has-messagesは付かない。 -->
<ol class =" custom-messages-area custom-messages-area-has-messages ">
<!-- 1 -->
<li class =" custom-message-cell ">
<div class =" custom-thumb "><img src =" * " alt =" アバター画像 " width =" 40 " height =" 40 "></div>
<div>
<p class=" custom-name "> ゆい </p>
<p class = " custom-message-body "> イベントはっじまーるよー\(^o^)/ </p>
<time class = " custom-time "> 20:11 </time>
</div>
</li>
<!-- /1 -->
<!-- 2 -->
<li class =" custom-stamp-cell ">
<div class =" custom-thumb " ><img src =" * " alt =" アバター画像 " width =" 40 " height =" 40 "></div>
<div>
<p class=" custom-name "> ひろみ </p>
<p class=" custom-stamp-body "> <img src =" * " alt =" スタンプ画像 " width =" 40 " height =" 40 "> </p>
<time class=" custom-time "> 20:12 </time>
</div>
</li>
<!-- /2 -->
</ol>
<!-- メッセージがある時はolにcustom-messages-area-has-messagesのカスタムクラスを付ける。custom-messages-area-no-messagesは付かない。 -->
<!-- メッセージがない時はolにcustom-messages-area-no-messagesのカスタムクラスを付ける。custom-messages-area-has-messagesは付かない。 -->
<ol class =" custom-messages-area custom-messages-area-has-messages ">
<!-- 1 -->
<li class =" custom-message-cell2 ">
<div class =" custom-thumb2 "><img src =" * " alt =" アバター画像 " width =" 40 " height =" 40 "></div>
<div>
<p class=" custom-message-body2 "> エクスデス討伐ありがとう!! </p>
<div>
<p class =" custom-name2 "> じゅん </p>
<time class = " custom-time2 "> 15:36 </time>
<a c lass =" custom-alert "> 通報する </a>
</div>
</div>
</li>
<!-- /1 -->
<!-- 2 -->
<li class =" custom-stamp-cell2 ">
<div class =" custom-thumb2 " ><img src =" * " alt =" アバター画像 " width =" 40 " height =" 40 "></div>
<div>
<div class = " custom-stamp-body2 " ><img src ="*" al t =" スタンプ画像 "></div>
<div>
<p class =" custom-name2 "> えりか </p>
<time class =" custom-time2 "> 15:41 </time>
</div>
</div>
</li>
<!-- /2 -->
</ol>
<!-- メッセージがある時はolにcustom-messages-area-has-messagesのカスタムクラスを付ける。custom-messages-area-no-messagesは付かない。 -->
<!-- メッセージがない時はolにcustom-messages-area-no-messagesのカスタムクラスを付ける。custom-messages-area-has-messagesは付かない。 -->
<ol class =" custom-messages-area ">
<!-- 1 -->
<li class =" custom-message-cell2-mine ">
<div>
<div>
<time class =" custom-time2 "> 15:45 </time>
</div>
<p class =" custom-message-body2-mine "> みんなで出撃しましょう! </p>
</div>
</li>
<!-- /1 -->
<!-- 2 -->
<li class =" custom-stamp-cell2-mine ">
<div>
<div>
<time class =" custom-time2 "> 15:45 </time>
</div>
<div class =" custom-stamp-body2-mine "><img src =" * " alt =" スタンプ画像 "></div>
</div>
</li>
<!-- /2 -->
</ol>
<!-- メッセージがある時はolにcustom-messages-area-has-messagesのカスタムクラスを付ける。custom-messages-area-no-messagesは付かない。 -->
<!-- メッセージがない時はolにcustom-messages-area-no-messagesのカスタムクラスを付ける。custom-messages-area-has-messagesは付かない。 -->
<ol class =" custom-messages-area custom-messages-area-no-messages ">
</ol>
<!-- メッセージが無い場合のスタイル例 -->
<style>
.custom-messages-area-no-messages {
height: 40px;
}
.custom-messages-area-no-messages:after {
content: "no massages...";
display: block;
padding: 10px;
text-align: center;
}
</style>
サンプル
-
HTML
<mobage:embedChat data-plugins-type="mbga-game-chat" data-talk-id="100001234" data-product-name="chat room name" data-widget-mode="message_list" data-use-stream="true" data-style-sheet="http://example.com/sample.css"></mobage:embedChat> -
CSS
.third .custom-log-controller-area {background : linear-gradient(to bottom, #636363 0%, #4B4B4B 83%, #424242 100%);color : #fff;}備考
2013年12月より Game chat Widget(Android)に既存の「チャットで見る」ボタンに加え、「アプリで開く」ボタンを追加されました。
ユーザの端末に「Mobage Chat」アプリがインストールされている場合、「Mobage Chat」アプリで開かれます。
ユーザの端末に「Mobage Chat」アプリがインストールされていない場合、Google PlayのAndroidアプリダウンロード画面に遷移します。
:::
更新履歴
- 2014/04/24
- Android向け「アプリで開く」ボタンの詳細を追加
- 2013/06/20
- 属性に data-stamp-size を追加
- custom-post-form-area の HTML 更新
- 2013/05/29
- 属性に data-widget-mode を追加
- 属性に data-use-stream を追加
- 属性に data-preview-limit を追加
- HTML 構成と CSS クラスを詳説
- 2013/04/25
- 新規作成