フルフィルメント（Dialogflow）

フルフィルメントロジックでは、すべてのリクエストから受け取るロケール文字列を使用して、ユーザーへのレスポンスを作成できます。このガイドでは、Cloud Functions for Firebase 内でサードパーティのローカライズライブラリを使用して、ローカライズされたレスポンスを返す方法について説明します。

ローカライズライブラリ

特定のロケール用にカスタマイズされたレスポンスを生成するのに役立つ主なライブラリを以下に示します。

汎用: I18n-node（下記サンプルコードスニペットでこのライブラリが使用されます）
汎用: format.js
タイムゾーン / 時間ローカライズ: moment.js（下記サンプルコードスニペットでこのライブラリが使用されます）
金額/通貨: numeral.js

ローカライズされたレスポンスを作成する

このセクションでは、ローカライズされた文字列を含むローカライズ文字列リソースファイルを作成する方法と、Cloud Functions for Firebase のフルフィルメントでこれらのリソースファイルを使用する方法について説明します。

ローカライズされたレスポンスを作成するには:

package.json ファイルと index.js ファイルと同じディレクトリに、ローカライズされた文字列ファイル用の locales ディレクトリ。ここでは <project-dir>/functions/locales として作成します。
サポートしたいロケールごとに、ローカライズされた文字列を含むリソースファイルを作成します。たとえば、en-US、en-GB、ローカライズされたウェルカムメッセージと日付メッセージを含む de-DE ロケール、次のようになります。

<project-dir>/functions/locales/en-US.json
```
{
   "WELCOME_BASIC": "Hello, welcome!",
   "DATE": "The date is %s"
}
```
<project-dir>/functions/locales/en-GB.json
```
{
   "WELCOME_BASIC": "Hello, welcome!",
   "DATE": "The date is %s"
}
```
<project-dir>/functions/locales/de-DE.json
```
{
   "WELCOME_BASIC": "Hallo und willkommen!",
   "DATE": "Das Datum ist %s"
}
```

package.json ファイルで、i18n-node ライブラリと moment ライブラリを次のように宣言します。 :

{
 ...
 "dependencies": {
   "actions-on-google": "^2.7.0",
   "firebase-admin": "^7.2.1",
   "firebase-functions": "^2.2.1",
   "i18n": "^0.8.3",
   "moment": "^2.22.1"
 }
}

index.js ファイルで、i18n-node の依存関係を宣言します。ライブラリ:
```
const i18n = require('i18n');
const moment = require('moment');
```

index.js ファイルで、サポートされているロケールを使用して i18n-node を構成します。

i18n.configure({
  locales: ['en-US', 'en-GB', 'de-DE'],
  directory: __dirname + '/locales',
  defaultLocale: 'en-US'
});

クライアントライブラリの conv.user.locale を使用してライブラリのロケールを設定するプロパティです。
```
app.middleware((conv) => {
  i18n.setLocale(conv.user.locale);
  moment.locale(conv.user.locale);
});
```
ローカライズされたレスポンスを返すには、ローカライズされた文字列を使用して ask() を呼び出します。返されます。さらにこのスニペットには、ローカライズされた日付を返すために moment を使用する関数も含まれています。
```
app.intent('Default Welcome Intent', (conv) => { // must not be async for i18n
  conv.ask(i18n.__('WELCOME_BASIC'));
});

app.intent('date', (conv) => { // must not be async for i18n
  conv.ask(i18n.__('DATE', moment().format('LL')));
});
```

完全な index.js ファイルの例を以下に示します。

'use strict';
const {dialogflow} = require('actions-on-google');
const functions = require('firebase-functions');
const i18n = require('i18n');
const moment = require('moment');

i18n.configure({
  locales: ['en-US', 'en-GB', 'de-DE'],
  directory: __dirname + '/locales',
  defaultLocale: 'en-US'
});

const app = dialogflow({debug: true});

app.middleware((conv) => {
  i18n.setLocale(conv.user.locale);
  moment.locale(conv.user.locale);
});

app.intent('Default Welcome Intent', (conv) => { // must not be async for i18n
  conv.ask(i18n.__('WELCOME_BASIC'));
});

app.intent('date', (conv) => { // must not be async for i18n
  conv.ask(i18n.__('DATE', moment().format('LL')));
});

exports.demoAction = functions.https.onRequest(app);

フルフィルメント（Dialogflow）

ローカライズ ライブラリ

ローカライズされたレスポンスを作成する

ローカライズライブラリ