منطق تحقق شما میتواند از رشته محلی که در هر درخواست دریافت میکند برای ارائه پاسخ به کاربران استفاده کند. این راهنما به شما نشان میدهد که چگونه از برخی کتابخانههای بومیسازی شخص ثالث در Cloud Function برای Firebase استفاده کنید تا پاسخهای بومیسازیشده را برگردانید.
کتابخانههای بومیسازی
در اینجا چند کتابخانه مفید برای کمک به شما در تولید پاسخهای سفارشی برای مناطق خاص آورده شده است:
- هدف کلی: I18n-node (تکهکدهای نمونه ما از این کتابخانه استفاده میکنند)
- هدف کلی: format.js
- بومیسازی منطقه زمانی/زمان: moment.js (تکهکدهای نمونه ما از این کتابخانه استفاده میکنند)
- پول/واحد پول: numeral.js
ایجاد پاسخهای بومیسازیشده
این بخش به شما نشان میدهد که چگونه فایلهای منبع رشته بومیسازیشده را که حاوی رشتههای بومیسازیشده هستند ایجاد کنید و چگونه از این فایلهای منبع در «تابع ابری» خود برای تحقق 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 و moment را اعلام کنید: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()را با رشته بومیسازیشده برگرداندهشده توسط 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);