عیب‌یابی

این راهنما مشکلات رایجی که ممکن است با FloSync با آن‌ها مواجه شوید و نحوه رفع آن‌ها را پوشش می‌دهد. اگر مشکل شما اینجا پوشش داده نشده است، پرسش‌های متداول را بررسی کنید یا با پشتیبانی تماس بگیرید.

گزارش‌های تشخیصی #

FloSync گزارش‌های دقیقی را نگهداری می‌کند که می‌توانند در تشخیص مشکلات کمک کنند. این گزارش‌ها برای عیب‌یابی مشکلات همگام‌سازی، درک آنچه در طول یک جلسه اتفاق افتاده یا هنگام تماس با پشتیبانی بسیار ارزشمند هستند.

دسترسی به گزارش‌ها #

از منو:

• macOS: راهنما > باز کردن پوشه گزارش
• Windows: راهنما > باز کردن پوشه گزارش

مکان دستی:

• macOS: ~/Library/Application Support/FloSync/logs/
• Windows: %APPDATA%/FloSync/logs/

ساختار گزارش #

گزارش‌ها بر اساس تاریخ و ساعت سازماندهی شده‌اند:

logs/
├── 2026-01-19/
│   ├── 00.log    (نیمه‌شب تا ۱ بامداد)
│   ├── 01.log    (۱ تا ۲ بامداد)
│   ├── ...
│   └── 23.log    (۱۱ شب تا نیمه‌شب)
├── 2026-01-18/
│   └── ...

نگهداری گزارش‌ها #

گزارش‌ها به مدت ۷ روز نگهداری شده و هنگام راه‌اندازی FloSync به طور خودکار پاک می‌شوند. این زمان کافی برای عیب‌یابی را فراهم می‌کند بدون اینکه فضای دیسک بیش از حد مصرف شود.

محتوای گزارش‌ها #

گزارش‌ها شامل ورودی‌های دارای timestamp برای موارد زیر هستند:

• راه‌اندازی و خاموش شدن برنامه
• رویدادهای بارگذاری و پخش ویدیو
• رویدادهای همگام‌سازی و اصلاح‌ها
• اتصالات و قطع‌اتصالات همگام‌سازی شبکه
• انتقال صحنه در طول پخش زمان‌بندی‌شده
• خطاها و هشدارها

استفاده از گزارش‌ها برای عیب‌یابی #

1. مشکل را بازتولید کنید — زمان تقریبی وقوع مشکل را یادداشت کنید
2. پوشه گزارش را باز کنید — از راهنما > باز کردن پوشه گزارش استفاده کنید
3. فایل مناسب را پیدا کنید — به پوشه تاریخ بروید و فایل گزارش ساعت را باز کنید
4. به دنبال خطاها بگردید — به دنبال ورودی‌های علامت‌گذاری‌شده با «ERROR» یا «WARN» بگردید
5. زمینه را مرور کنید — ورودی‌های قبل و بعد از خطا را برای درک زمینه بخوانید

هنگام تماس با پشتیبانی، فایل‌های گزارش مرتبط را ضمیمه کنید تا تشخیص مشکل شما سریع‌تر انجام شود.

مشکلات بارگذاری محتوا #

تصویر بارگذاری نمی‌شود #

علائم: کشیدن یک تصویر روی FloSync هیچ اتفاقی نمی‌افتد یا یک خطا نمایش داده می‌شود.

علل احتمالی و راه‌حل‌ها:

1. فرمت پشتیبانی‌نشده

   • فرمت‌های پشتیبانی‌شده: PNG، JPG/JPEG، GIF، BMP، TIFF، WebP، SVG
   • با باز کردن فایل در یک نمایشگر تصویر دیگر، مطمئن شوید خراب نشده است

2. مجوزهای فایل

   • مطمئن شوید دسترسی خواندن به فایل تصویر دارید
   • اگر فایل روی یک network share است، آن را به یک درایو محلی کپی کنید

3. محدودیت‌های SVG

   • برخی ویژگی‌های پیچیده SVG ممکن است به درستی رندر نشوند
   • اگر SVG به درستی نمایش داده نمی‌شود، آن را به PNG تبدیل کنید

صفحه وب بارگذاری نمی‌شود #

علائم: صفحه وب در نمایشگر خالی یا با خطا نشان داده می‌شود.

علل احتمالی و راه‌حل‌ها:

1. HTTP در مقابل HTTPS

   • فقط URLهای HTTPS پشتیبانی می‌شوند (نه HTTP)
   • مطمئن شوید URL شما با https:// شروع می‌شود

2. اتصال شبکه

   • مطمئن شوید دسترسی به اینترنت دارید
   • بررسی کنید که وب‌سایت در یک مرورگر عادی قابل دسترسی است

3. وب‌سایت جاسازی را مسدود می‌کند

   • برخی وب‌سایت‌ها از جاسازی در WebView جلوگیری می‌کنند
   • یک وب‌سایت دیگر امتحان کنید یا به جای آن از یک فایل HTML محلی استفاده کنید

مشکلات پخش ویدیو #

ویدیو بارگذاری نمی‌شود #

علائم: کشیدن یک ویدیو روی FloSync هیچ اتفاقی نمی‌افتد یا یک خطا نمایش داده می‌شود.

علل احتمالی و راه‌حل‌ها:

1. فرمت پشتیبانی‌نشده

   • تبدیل به MP4 (H.264) را امتحان کنید — توصیه‌های کدک ویدیو را ببینید
   • با پخش در یک ویدئو پلیر دیگر، مطمئن شوید فایل خراب نشده است

2. کدک‌های گمشده

   • FloSync بیشتر کدک‌های رایج را در بر می‌گیرد، اما برخی فرمت‌های اختصاصی ممکن است کار نکنند
   • به یک فرمت استاندارد مثل MP4 تبدیل کنید

3. مجوزهای فایل

   • مطمئن شوید دسترسی خواندن به فایل ویدیو دارید
   • اگر فایل روی یک network share است، آن را به یک درایو محلی کپی کنید

ویدیو لکنت می‌کند یا فریم می‌افتد #

علائم: پخش ناهموار یا روان نیست.

راه‌حل‌ها:

1. استفاده CPU/GPU را بررسی کنید — اگر اشباع شده، سخت‌افزار شما ممکن است از وضوح ویدیو پشتیبانی نکند
2. از حافظه SSD استفاده کنید — هارد دیسک‌ها ممکن است برای ویدیوهای با نرخ بیت بالا به اندازه کافی سریع نباشند
3. وضوح ویدیو را کاهش دهید — اگر سخت‌افزار دچار مشکل است با وضوح پایین‌تر رمزگذاری مجدد کنید
4. سایر برنامه‌ها را ببندید — منابع سیستم را آزاد کنید
5. تحمل همگام‌سازی را بررسی کنید — اگر از همگام‌سازی استفاده می‌کنید، برای کاهش اصلاح‌ها تحمل را افزایش دهید

مشکلات نمایشگر #

نمایشگر دوم تشخیص داده نمی‌شود #

علائم: FloSync فقط یک نمایشگر نشان می‌دهد در حالی که چندین نمایشگر متصل است.

راه‌حل‌ها:

1. تنظیمات نمایشگر OS را بررسی کنید

   • macOS: System Settings > Displays
   • Windows: Settings > System > Display
   • تأیید کنید همه نمایشگرها توسط OS تشخیص داده شده‌اند

2. اتصالات کابل را بررسی کنید

   • کابل‌های مختلف امتحان کنید
   • پورت‌های مختلف روی رایانه امتحان کنید

3. FloSync را راه‌اندازی مجدد کنید بعد از اتصال نمایشگرهای جدید

   • FloSync هنگام راه‌اندازی نمایشگرها را تشخیص می‌دهد

چیدمان نمایشگر مطابقت ندارد #

علائم: در حالت گسترده، بخش‌های ویدیو روی نمایشگرهای اشتباه نمایش داده می‌شوند.

راه‌حل‌ها:

1. چیدمان نمایشگر OS را پیکربندی کنید

   • macOS: System Settings > Displays > Arrange
   • Windows: Settings > System > Display (برای چیدمان بکشید)
   • چیدمان مجازی را با راه‌اندازی فیزیکی خود هماهنگ کنید

2. FloSync را راه‌اندازی مجدد کنید بعد از تغییر چیدمان

مشکلات همگام‌سازی #

نمایشگرها ناهماهنگ هستند (محلی) #

علائم: در حالت آینه‌ای یا گسترده، نمایشگرها فریم‌های مختلف نشان می‌دهند.

راه‌حل‌ها:

1. منتظر اصلاح خودکار باشید — FloSync به طور خودکار انحراف پایدار را اصلاح می‌کند
2. نوار وضعیت را بررسی کنید — در حالت پخش زنده، شمارنده اصلاح‌های همگام‌سازی نشان می‌دهد چند اصلاح انجام شده است:
   • تعداد کم در جلسات طولانی طبیعی است
   • تعداد تکرارشونده یا افزایش سریع می‌تواند نشانه مشکل راه‌اندازی باشد
3. تحمل همگام‌سازی را کاهش دهید — تحمل همگام‌سازی را در تنظیمات برگزیده کاهش دهید
4. گزارش همگام‌سازی را بررسی کنید — به دنبال هشدارهای انحراف و اصلاح‌ها بگردید
5. پخش را راه‌اندازی مجدد کنید — مکث کنید، سپس دوباره پخش کنید

همگام‌سازی شبکه کار نمی‌کند #

علائم: کلاینت نمی‌تواند سرور را پیدا کند یا همگام‌سازی بعد از اتصال کار نمی‌کند.

راه‌حل‌ها:

1. بررسی شبکه مشترک

   • هر دو رایانه باید روی همان شبکه محلی باشند
   • با ping بین دستگاه‌ها تأیید کنید

2. فایل ویدیوی یکسان

   • کلاینت‌ها باید همان ویدیو را بارگذاری کرده باشند
   • اگر طول ویدیوها متفاوت باشد، همگام‌سازی شکست می‌خورد

3. بررسی فایروال

   • FloSync را روی هر دو دستگاه در فایروال مجاز کنید
   • UDP port 9201 را مجاز کنید

4. بررسی در حال اجرا بودن سرور

   • تأیید کنید آیکون سرور (برج) در نوار بالا سبز است
   • بررسی کنید نوار وضعیت «Server» را نشان می‌دهد
   • آیکون را کلیک کنید تا حالت سرور متوقف و راه‌اندازی مجدد شود

5. منتظر تثبیت اولیه باشید

   • همگام‌سازی شبکه ممکن است بعد از اتصال کمی زمان نیاز داشته باشد تا تثبیت شود
   • برخی اصلاح‌های اولیه طبیعی هستند
   • بعد از تثبیت، پخش باید پایدار و به طور تصویری هماهنگ بماند

انحراف تدریجی همگام‌سازی بعد از روزها آپ‌تایم #

علائم: همگام‌سازی شبکه کاملاً کار می‌کرد، اما بعد از چند روز عملکرد پیوسته، کلاینت به طور مداوم ۵۰-۱۰۰ms عقب است و کاملاً خودترمیمی نمی‌کند.

علت: ساعت سیستم هر رایانه به دلیل تغییرپذیری نوسان‌ساز سخت‌افزاری و دما با نرخ کمی متفاوتی انحراف پیدا می‌کند. بعد از روزها آپ‌تایم بدون وقفه، این انحراف انباشته می‌تواند از آنچه اصلاح ساعت در لحظه می‌تواند جبران کند تجاوز کند. این همه سیستم‌های همگام‌سازی مبتنی بر ساعت را تحت تأثیر قرار می‌دهد، نه فقط FloSync.

راه‌حل: هر دو رایانه را راه‌اندازی مجدد کنید. برای نصب‌های بدون نظارت، یک راه‌اندازی مجدد روزانه در ساعات خاموش برنامه‌ریزی کنید — زمان‌بندی راه‌اندازی مجدد منظم در راهنمای بهینه‌سازی همگام‌سازی را ببینید.

اصلاح‌های همگام‌سازی باعث لکنت می‌شوند #

علائم: ویدیو مکرراً در طول پخش می‌پرد یا لکنت می‌کند.

راه‌حل‌ها:

1. تحمل همگام‌سازی را در تنظیمات برگزیده افزایش دهید
2. کیفیت شبکه را بررسی کنید (برای همگام‌سازی شبکه)
3. بار سیستم را کاهش دهید — برنامه‌های غیرضروری را ببندید
4. الگوها را در گزارش همگام‌سازی بررسی کنید

مشکلات پخش زنده #

پنجره‌های تمام‌صفحه نمایش داده نمی‌شوند #

علائم: کلیک کردن پخش زنده پنجره‌های تمام‌صفحه روی نمایشگرها ایجاد نمی‌کند.

راه‌حل‌ها:

1. تشخیص نمایشگر را بررسی کنید

   • مطمئن شوید نمایشگرهای شما تشخیص داده شده‌اند (باید در ناحیه چیدمان نمایشگر نشان داده شوند)
   • نمایشگرها را جدا کرده و دوباره وصل کنید
   • بعد از اتصال نمایشگرهای جدید FloSync را راه‌اندازی مجدد کنید

2. بارگذاری ویدیو را بررسی کنید

   • مطمئن شوید حداقل یک ویدیو قبل از پخش زنده بارگذاری شده است
   • به دنبال نشانگرهای «ویدیوی گمشده» بگردید

3. مجوزها را بررسی کنید

   • در macOS، مطمئن شوید FloSync مجوز کنترل رایانه شما را دارد (System Settings > Privacy & Security > Accessibility)
   • در Windows، FloSync را به عنوان administrator اجرا کنید

کلید ESC از حالت پخش زنده خارج نمی‌شود #

علائم: فشار دادن ESC روی یک پنجره تمام‌صفحه از حالت پخش زنده خارج نمی‌شود.

راه‌حل‌ها:

1. مطمئن شوید پنجره فوکوس دارد — ابتدا روی پنجره تمام‌صفحه کلیک کنید
2. دکمه توقف پخش زنده را امتحان کنید — به پانل کنترل برگردید و «توقف پخش زنده» را کلیک کنید
3. در صورت لزوم اجباراً ببندید — به عنوان آخرین راه‌حل از Cmd+Q (macOS) یا Alt+F4 (Windows) استفاده کنید

مشکلات برنامه #

FloSync راه‌اندازی نمی‌شود #

راه‌حل‌های macOS:

1. تنظیمات امنیتی

   • روی FloSync کلیک راست کنید و «Open» را انتخاب کنید
   • یا: System Settings > Privacy & Security > Allow FloSync

2. پاک کردن تنظیمات برگزیده

   • حذف کنید: ~/Library/Application Support/com.tentekio.flosync/
   • FloSync را دوباره راه‌اندازی کنید

راه‌حل‌های Windows:

1. به عنوان Administrator اجرا کنید

   • روی FloSync کلیک راست کنید > Run as administrator

2. پاک کردن تنظیمات برگزیده

   • حذف کنید: %APPDATA%\Tentekio\FloSync\
   • FloSync را دوباره راه‌اندازی کنید

3. Visual C++ Redistributable را دوباره نصب کنید

   • آخرین نسخه را از Microsoft دانلود کنید

استفاده بالای CPU/Memory #

علائم: FloSync منابع سیستم بیش از حد مصرف می‌کند.

راه‌حل‌ها:

1. رفتار مورد انتظار — پخش ویدیو به منابع قابل توجهی نیاز دارد
2. وضوح ویدیو را کاهش دهید — اگر دچار مشکل هستید به جای 4K از 1080p استفاده کنید
3. تعداد ویدیوهای همزمان را کاهش دهید — در حالت مستقل
4. پانل گزارش همگام‌سازی را ببندید — ثبت گزارش منابعی مصرف می‌کند
5. به دنبال فرآیندهای بی‌رویه بگردید — اگر استفاده از منابع بعد از توقف ویدیو کاهش نمی‌یابد FloSync را راه‌اندازی مجدد کنید

مشکلات کدک ویدیو #

اگر هنگام استفاده از همگام‌سازی شبکه با انحراف همگام‌سازی یا پخش ناسازگار مواجه هستید، کدک ویدیوی شما ممکن است علت باشد.

راه‌حل سریع: ویدیوی خود را به H.264 All-Intra تبدیل کنید تا بهترین عملکرد همگام‌سازی را روی همه پلتفرم‌ها داشته باشید. ProRes LT و DNxHD نیز جایگزین‌های پشتیبانی‌شده هستند.

برای راهنمایی دقیق درباره فرمت‌های ویدیو، کدک‌های توصیه‌شده، فایل‌های نمونه برای آزمایش و دستورات FFmpeg برای تبدیل، راهنمای جامع آماده‌سازی ویدیو ما را ببینید.

مشکلات شناخته‌شده #

محدودیت‌های فعلی #

• حالت گسترده ممکن است در مرزهای bezel کاملاً تراز نشود
• همگام‌سازی شبکه Wi-Fi کمتر از اتصال سیمی قابل اعتماد است
• برخی محتوای DRM-protected قابل پخش نیست
• ویدیوهای با وضوح بسیار بالا (8K و بالاتر) ممکن است روی همه سخت‌افزارها خوب اجرا نشوند
• حالت نمایشگر نمی‌تواند در حالت پخش زنده تغییر کند (ابتدا از پخش زنده خارج شوید)
• صفحات وب نمی‌توانند روی چند نمایشگر گسترش یابند (در حالت گسترده آینه‌ای نمایش داده می‌شوند)
• فقط URLهای HTTPS برای صفحات وب پشتیبانی می‌شوند (نه HTTP)
• همگام‌سازی شبکه فقط با محتوای ویدیو کار می‌کند (تصاویر و صفحات وب همگام‌سازی نمی‌شوند)

نکات برای بهترین عملکرد #

• برای همگام‌سازی شبکه از اتصالات شبکه سیمی استفاده کنید
• فایل‌های محتوا را روی حافظه محلی نگه دارید (نه درایوهای شبکه)
• پیکربندی‌های نمایشگر ثابتی را در طول جلسات استفاده کنید
• راه‌اندازی خود را قبل از ارائه‌های مهم آزمایش کنید
• هنگام استفاده از زمان‌بندی، انتقال‌ها را با صحنه‌های با زمان کوتاه ابتدا آزمایش کنید