تحقق (Dialogflow)

منطق تحقق شما می‌تواند از رشته محلی که در هر درخواست دریافت می‌کند برای ارائه پاسخ به کاربران استفاده کند. این راهنما به شما نشان می‌دهد که چگونه از برخی کتابخانه‌های بومی‌سازی شخص ثالث در Cloud Function برای Firebase استفاده کنید تا پاسخ‌های بومی‌سازی‌شده را برگردانید.

کتابخانه‌های بومی‌سازی

در اینجا چند کتابخانه مفید برای کمک به شما در تولید پاسخ‌های سفارشی برای مناطق خاص آورده شده است:

  • هدف کلی: I18n-node (تکه‌کدهای نمونه ما از این کتابخانه استفاده می‌کنند)
  • هدف کلی: format.js
  • بومی‌سازی منطقه زمانی/زمان: moment.js (تکه‌کدهای نمونه ما از این کتابخانه استفاده می‌کنند)
  • پول/واحد پول: numeral.js

ایجاد پاسخ‌های بومی‌سازی‌شده

این بخش به شما نشان می‌دهد که چگونه فایل‌های منبع رشته بومی‌سازی‌شده را که حاوی رشته‌های بومی‌سازی‌شده هستند ایجاد کنید و چگونه از این فایل‌های منبع در «تابع ابری» خود برای تحقق Firebase استفاده کنید.

برای ایجاد پاسخ‌های بومی‌سازی‌شده:

  1. در همان فهرست راهنمای فایل‌های package.json و index.js، فهرست راهنمای locales را برای فایل‌های رشته بومی‌سازی‌شده ایجاد کنید. این دایرکتوری را <project-dir>/functions/locales می‌نامیم.
  2. فایل منبعی ایجاد کنید که حاوی رشته‌های بومی‌سازی‌شده برای هر منطقه‌ای باشد که می‌خواهید پشتیبانی کنید. برای مثال، اگر می‌خواهید از زبان‌های 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"
    }
    
  3. در فایل 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"
     }
    }
    
  4. در فایل index.js، وابستگی‌های کتابخانه‌های i18n-node و moment را اعلام کنید:

    const i18n = require('i18n');
    const moment = require('moment');

  5. در فایل index.js، i18n-node را با زبان‌های پشتیبانی‌شده‌تان پیکربندی کنید:

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

  6. منطقه زبانی کتابخانه‌ها را بااستفاده از conv.user.locale از ویژگی کتابخانه مشتری تنظیم کنید.

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

  7. برای برگرداندن پاسخ بومی‌سازی‌شده، ask() را با رشته بومی‌سازی‌شده برگردانده‌شده توسط i18n فراخوانی کنید. این گزیده همچنین حاوی تابعی است که از 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);