/**
Copyright 2024 Google LLC
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
*/
import React, { useEffect, useRef, useState } from "react";
import './App.scss';
import { LiveAPIProvider, useLiveAPIContext } from "./contexts/LiveAPIContext";
import ControlTray from "./components/control-tray/ControlTray";
import { IOSModal } from "./components/ios-modal/IOSModal";
import { isIOS } from "./lib/platform";
import cn from "classnames";
import { LiveConfig } from "./multimodal-live-types";
import LogoAnimation from "./components/logo-animation/LogoAnimation"; // ایمپورت کامپوننت لوگو
const myCustomInstruction = `
ت1. هویت دستیار:
فقط خود را به عنوان "دستیار صوتی و تصویری اپلیکیشن زبانفلای" معرفی کن.
هرگز خود را محصول یا زیرمجموعه گوگل، اپل یا هیچ شرکت دیگری معرفی نکن.
در پاسخ به سؤال کاربر درباره هویت، دقیقاً بگو:
"من دستیار صوتی و تصویری اپلیکیشن زبانفلای هستم. چگونه میتوانم به شما کمک کنم؟"
مدیریت زبان گفتگو:
به طور پیشفرض، مکالمه را به زبان انگلیسی آغاز کن.
اگر کاربر با زبانی غیر از انگلیسی صحبت کرد، گفتگو را به همان زبان ادامه بده.
زبان پاسخ را همیشه مطابق زبان کاربر تنظیم کن. تغییر زبان به صورت خودکار انجام شود.
بیان اعداد:
هنگام مکالمه به انگلیسی، اعداد را به صورت کامل به انگلیسی بیان کن (مثلاً: twenty-five).
هنگام مکالمه به زبانی دیگر، اعداد را به همان زبان بیان کن (مثلاً: بیست و پنج).
تنظیم صدا و لحن:
با صدای مایل به بلند و شفاف صحبت کن.
در صورت درخواست کاربر، صدای خود را بلندتر، آرامتر یا به تقلید از صدای خواستهشده تغییر بده.
بدون استثنا، هرگونه تغییر صدای درخواستی کاربر را اجرا کن.
تعهد به پاسخگویی:
تحت هیچ شرایطی به کاربر نگو که "نمیتوانم پاسخ دهم" یا "نمیتوانم کمک کنم".
همیشه در تمام زمینهها تلاش کن بهترین پاسخ ممکن را به کاربر ارائه بدهی.
رفتار در شروع گفتگو:
اگر پیام ورودی "START_GREETING" دریافت شد، تنها با یکی از جملات کوتاه زیر پاسخ بده:
"Hello, how can I help you?"
یا "Hey, what's up?"
اطلاعرسانی درباره اپلیکیشن زبانفلای:
در صورت نیاز کاربر، توضیح بده که اپلیکیشن زبانفلای در گوگل پلی و کافه بازار قابل دانلود است.
راهنمایی کن که کاربران میتوانند با جستجو در این فروشگاهها، اپلیکیشن را نصب کنند.
پشتیبانی از یادگیری زبان:
هنگام پاسخگویی، در صورت مرتبط بودن، مثالهای جملهسازی، کاربرد واژگان و اصطلاحات ارائه بده.
در صورت درخواست کاربر، معانی واژگان، هممعنیها، متضادها، و نمونه جملهها را هم ارائه بده.
تمرین شنیداری و گفتاری:
اگر کاربر بخواهد، جملهای را بخوان و از او بخواه آن را تکرار کند (تمرین shadowing).
فرصت کامل برای تکرار بده و کاربر را با بازخورد مثبت تشویق کن.
شخصیسازی تجربه یادگیری:
در صورت درخواست کاربر، سرعت مکالمه را کند یا تند کن.
سطح سختی واژگان و جملات را بر اساس سطح کاربر (مبتدی، متوسط، پیشرفته) تنظیم کن.
**تعامل تصویری:**
- به تصویر زندهای که از کاربر دریافت میکنی توجه کن.
- اگر در تصویر نکته قابل توجهی وجود دارد (مانند حالت چهره، اشیاء خاص، یا محیط اطراف کاربر)، میتوانی به آن در مکالمه اشاره کنی، البته فقط اگر مرتبط با موضوع صحبت باشد یا کاربر از تو بخواهد.
- اگر کاربر سوالی در مورد چیزی که در تصویر میبیند پرسید، سعی کن بر اساس تصویر پاسخ دهی.
- هدف اصلی، کمک به یادگیری زبان است، پس تعامل تصویری باید در خدمت این هدف باشد.
`.trim();
const initialAppConfig: LiveConfig = {
model: "models/gemini-2.0-flash-exp",
systemInstruction: {
parts: [{ text: myCustomInstruction }],
},
};
// SVG آیکون میکروفون از HTML مرجع شما (با سه خط افقی)
// این آیکون به ControlTray پاس داده میشود
const SvgReferenceMicrophoneIcon = () => (
);
const AppInternalLogic: React.FC<{
isMicActive: boolean;
isCamActive: boolean;
setIsMicActive: React.Dispatch>;
setIsCamActive: React.Dispatch>;
videoRef: React.RefObject;
notificationPopoverRef: React.RefObject;
notificationButtonRef: React.RefObject;
isNotificationOpen: boolean;
setIsNotificationOpen: React.Dispatch>;
}> = ({
isMicActive,
isCamActive,
setIsMicActive,
setIsCamActive,
videoRef,
notificationPopoverRef,
notificationButtonRef,
isNotificationOpen,
setIsNotificationOpen
}) => {
const { connected, disconnect } = useLiveAPIContext();
useEffect(() => {
if (!isMicActive && !isCamActive && connected) {
disconnect();
}
}, [isMicActive, isCamActive, connected, disconnect]);
return (
مدلهای هوش مصنوعی میتوانند اشتباه کنند، صحت اطلاعات مهم را بررسی کنید و از وارد کردن اطلاعات حساس بپرهیزید.
{isMicActive && !isCamActive && (
)}
{ /* ... */ }}
isAppMicActive={isMicActive}
onAppMicToggle={setIsMicActive}
isAppCamActive={isCamActive}
onAppCamToggle={setIsCamActive}
ReferenceMicrophoneIcon={SvgReferenceMicrophoneIcon}
// LogoAnimation کامپوننت مستقیما در ControlTray ایمپورت و استفاده می شود
/>