メインコンテンツまでスキップ

チャットサービス

アプリケーションにチャットのウィジェットを貼ります。投稿されたメッセージは 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プレビュー時に表示するメッセージの最大数1data-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
    • 新規作成
  • 定義
    • 要素名
    • 属性
  • ウィジェットのモード
    • simple_message_list モード
    • message_list モード
    • preview モード
  • HTML 構成と CSS クラス
    • custom-log-controller-area
    • custom-open-chat-app-area
    • custom-header-area
    • custom-open-log-reload-area
    • custom-preview-close-cell
    • custom-preview-open-cell
    • custom-post-form-area
    • custom-preview-cell
    • custom-messages-area
  • サンプル
  • 更新履歴