هشدارها و خطاها

وضعیت	جاری
مالک	تیم محصول آپارات TV
آخرین بازبینی	۱۴۰۵/۰۵/۲۷ — در برابر صفحه Alerts & Errors - 1.0.0 طراحی AndroidTV و سند context محصول

معرفی و هدف

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

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

هدف کسب‌وکار: کاهش رها کردن اپلیکیشن و کاهش تماس با پشتیبانی، با تبدیل هر خطا به یک قدم بعدیِ روشن که کاربر خودش می‌تواند بردارد.

دامنه

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

خارج از دامنه:

• خطاهایی که به یک جریان مشخص تعلق دارند — هر خطایی که فقط در یک بخش معنا دارد، در همان بخش مستند شده است. مهم‌ترین نمونه‌ها: خطاهای صفحه جستجو که نوار جستجو و عبارت کاربر را حفظ می‌کنند، خطاهای لیست‌های من، خطاهای ورود در ورود به حساب کاربری، پیام دسترسی شبکه‌ای فیلم و سریال، و خطاهای پخش در پخش ویدیو و پخش زنده.
• حالت‌های خالی — نبودن محتوا خطا نیست؛ حالت خالی هر بخش در همان بخش مستند شده است.

مخاطبان و نقش‌ها

این پیام‌ها به وضعیت حساب کاربری ربطی ندارند و برای همه کاربران یکسان نمایش داده می‌شوند.

واژه‌نامه

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

قواعد کسب‌وکار

• BR-1 — خطاهای این بخش تمام‌صفحه هستند: وقتی هیچ محتوایی برای نمایش نیست، پیام کل ناحیه محتوا را می‌گیرد.
• BR-2 — هر خطای این بخش سه چیز دارد: یک عنوان کوتاه که می‌گوید چه شده، یک توضیح که می‌گوید کاربر چه کند، و یک اکشن — معمولاً «تلاش مجدد».
• BR-3 — اپلیکیشن قطع اینترنت را از خطای سرویس جدا می‌کند؛ این دو پیام و عنوان متفاوت دارند چون اقدام کاربر در آن‌ها فرق می‌کند.
• BR-4 — وقتی یک خطا به یک بخش مشخص تعلق دارد، همان بخش نسخه خودش را نشان می‌دهد و چارچوب صفحه و ورودی کاربر را حفظ می‌کند؛ پیام سراسری فقط جایی می‌آید که چنین چارچوبی وجود نداشته باشد.
• BR-5 — به‌روزرسانی اجباری مانع ادامه استفاده است: پیام تمام‌صفحه است و متن آن نصب نسخه تازه را شرط ادامه استفاده اعلام می‌کند.
• BR-6 — به‌روزرسانی اختیاری به‌صورت دیالوگ روی محتوای صفحه می‌آید و کاربر می‌تواند از آن بگذرد و به کارش ادامه دهد.
• BR-7 — اجازه میکروفون فقط زمانی خواسته می‌شود که کاربر جستجوی صوتی را انتخاب کند، و سه گزینه دارد: اجازه در حین استفاده، اجازه فقط این یک بار، و اجازه ندادن.
• BR-8 — متن درخواست اجازه میکروفون خودش راه بازگشت را می‌گوید: کاربر می‌تواند بعداً این تصمیم را از تنظیمات دستگاه تغییر دهد.

سناریوها

سناریوی ۱: مواجهه با قطع اینترنت

هدف — کاربر می‌فهمد مشکل از اتصال اینترنت خود اوست و می‌تواند بدون بستن اپلیکیشن دوباره تلاش کند.

نقش‌های درگیر — همه کاربران.

پیش‌نیازها — کاربر در بخشی از اپلیکیشن است که برای نمایش محتوا به اینترنت نیاز دارد.

جریان اصلی

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

۲. کاربر اتصال تلویزیونش را بررسی و درست می‌کند. ۳. کاربر «تلاش مجدد» را انتخاب می‌کند. → همان درخواستی که شکست خورده بود دوباره اجرا می‌شود و در صورت موفقیت، محتوا جای پیام را می‌گیرد.

جریان‌های جایگزین و استثنا

• ۱a. خطا در بخشی رخ می‌دهد که نسخه خودش را دارد (BR-4):
  • ۱a1. به‌جای این پیام تمام‌صفحه، نسخه همان بخش نمایش داده می‌شود؛ مثلاً در جستجو پیام درون صفحه می‌آید و نوار جستجو و عبارت کاربر حفظ می‌شوند.
• ۳a. اتصال هنوز برقرار نشده است:
  • ۳a1. همان پیام دوباره نمایش داده می‌شود و کاربر می‌تواند باز هم تلاش کند.

پس‌شرط‌ها — یا محتوا بارگذاری شده، یا کاربر روی همان پیام با امکان تلاش دوباره مانده است.

---

سناریوی ۲: مواجهه با خطای در دسترس نبودن صفحه

هدف — کاربر می‌فهمد اتصالش سالم است اما محتوای درخواست‌شده در دسترس نیست.

نقش‌های درگیر — همه کاربران.

پیش‌نیازها — دستگاه به اینترنت متصل است.

جریان اصلی

۱. درخواست محتوا شکست می‌خورد در حالی که اتصال برقرار است (BR-3). → پیام تمام‌صفحه با عنوان «عدم دسترسی» و توضیح «صفحه مورد نظر شما در دسترس نیست» و دکمه «تلاش مجدد» نمایش داده می‌شود.

۲. کاربر «تلاش مجدد» را انتخاب می‌کند. → درخواست دوباره اجرا می‌شود.

جریان‌های جایگزین و استثنا

• ۱a. همین خطا درون بخشی رخ می‌دهد که چارچوب خودش را دارد (BR-4):
  • ۱a1. عنوان ممکن است متفاوت باشد — در جستجو و لیست‌های من این خطا با عنوان «خطا در دریافت اطلاعات» و همان توضیح «صفحه مورد نظر شما در دسترس نیست» نمایش داده می‌شود.
• ۲a. خطا تکرار می‌شود:
  • ۲a1. کاربر می‌تواند با منوی کنار به بخش دیگری از اپلیکیشن برود؛ این خطا مانع استفاده از بقیه اپلیکیشن نیست.

پس‌شرط‌ها — یا محتوا بارگذاری شده، یا کاربر به بخش دیگری رفته است.

---

سناریوی ۳: مواجهه با خطای ارتباط با سرویس پخش

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

نقش‌های درگیر — همه کاربران.

پیش‌نیازها — اپلیکیشن نتوانسته با سرویس پخش ارتباط بگیرد.

جریان اصلی

۱. ارتباط با سرویس پخش برقرار نمی‌شود. → پیام تمام‌صفحه با عنوان «در حال حاضر، ارتباط با سرویس پخش برقرار نیست.» و راهنمای «لطفاً موارد زير را به ترتيب بررسى كنيد:» نمایش داده می‌شود، با پنج گام:

۱. در صورت استفاده از Wi-Fi، كيفيت و پایداری اتصال را بررسى كنيد. ۲. تاريخ و ساعت دستگاه را از بخش تنظيمات به صورت دستی تنظيم كنيد. ۳. مودم اینترنت را یک‌بار خاموش و روشن كنيد. ۴. در صورت استفاده از VPN يا فيلترشكن، آن‌را غير فعال كنيد. ۵. چند دقيقه صبر كرده و دوباره تلاش كنيد.

۲. کاربر گام‌ها را به ترتیب بررسی می‌کند. ۳. کاربر «تلاش مجدد» را انتخاب می‌کند. → اپلیکیشن دوباره تلاش می‌کند و در صورت موفقیت به کار عادی برمی‌گردد.

جریان‌های جایگزین و استثنا

• ۱a. علت واقعی، نادرست بودن تاریخ و ساعت دستگاه است:
  • ۱a1. این حالت به‌طور خاص در گام دوم راهنما پوشش داده شده است؛ اپلیکیشن خودش تاریخ و ساعت را تنظیم نمی‌کند و کاربر باید آن را از تنظیمات دستگاه انجام دهد.
• ۳a. پس از انجام همه گام‌ها مشکل باقی می‌ماند:
  • ۳a1. گام پنجم راهنما خودش کاربر را به صبر کردن و تلاش دوباره ارجاع می‌دهد.

پس‌شرط‌ها — یا ارتباط با سرویس پخش برقرار شده، یا کاربر راهنمای رفع مشکل را در اختیار دارد.

---

سناریوی ۴: به‌روزرسانی اجباری اپلیکیشن

هدف — کاربر نسخه‌ای را نصب می‌کند که بدون آن ادامه استفاده ممکن نیست.

نقش‌های درگیر — همه کاربران.

پیش‌نیازها — نسخه نصب‌شده روی دستگاه دیگر پشتیبانی نمی‌شود.

جریان اصلی

۱. اپلیکیشن وجود نسخه اجباری تازه را تشخیص می‌دهد. → پیام تمام‌صفحه با عنوان «بروزرسانی جدید، نسخه [شماره نسخه]» و توضیح «نسخه جدیدی از برنامه منتشر شده، لطفا برای ادامه استفاده از آپارات، حتما نسخه جدید را نصب کنید.» نمایش داده می‌شود، با دکمه‌های «دانلود و نصب به‌روزرسانی» و «انصراف» (BR-5).

۲. کاربر «دانلود و نصب به‌روزرسانی» را انتخاب می‌کند. → فرایند دانلود و نصب نسخه تازه شروع می‌شود.

جریان‌های جایگزین و استثنا

• ۲a. کاربر «انصراف» را انتخاب می‌کند:
  • ۲a1. [CLARIFICATION NEEDED: طراحی در همان پیام می‌گوید نصب نسخه جدید برای ادامه استفاده الزامی است، اما دکمه «انصراف» هم دارد. رفتار پس از انصراف چیست — اپلیکیشن بسته می‌شود یا کاربر با محدودیت ادامه می‌دهد؟]
• ۲b. دانلود یا نصب به‌روزرسانی شکست می‌خورد:
  • ۲b1. [CLARIFICATION NEEDED: طراحی برای شکست دانلود یا نصب به‌روزرسانی فریمی ندارد.]

پس‌شرط‌ها — یا نسخه تازه در حال نصب است، یا کاربر روی همین پیام مانده است.

---

سناریوی ۵: به‌روزرسانی اختیاری اپلیکیشن

هدف — کاربر از وجود نسخه تازه باخبر می‌شود و می‌تواند همان لحظه به‌روزرسانی کند یا از آن بگذرد.

نقش‌های درگیر — همه کاربران.

پیش‌نیازها — نسخه تازه‌ای منتشر شده که نصب آن الزامی نیست.

جریان اصلی

۱. اپلیکیشن وجود نسخه تازه اختیاری را تشخیص می‌دهد. → دیالوگی روی محتوای صفحه باز می‌شود با عنوان «بروزرسانی جدید، نسخه [شماره نسخه]» و پرسش «نسخه جدیدی از برنامه منتشر شده، آیا می‌خواهید برای استفاده از آخرین بهبودها و ویژگی‌های آپارات، به‌روزرسانی انجام شود ؟»، با دو گزینه «بله، به‌روزرسانی بشه» و «انصراف از به‌روزرسانی» (BR-6).

۲. کاربر «بله، به‌روزرسانی بشه» را انتخاب می‌کند. → فرایند دانلود و نصب نسخه تازه شروع می‌شود.

جریان‌های جایگزین و استثنا

• ۱a. کاربر در حال تماشای ویدیویی است:
  • ۱a1. [CLARIFICATION NEEDED: طراحی این دیالوگ را فقط روی صفحه خانه نشان می‌دهد؛ مشخص نیست در حین پخش هم نمایش داده می‌شود یا تا پایان پخش به تعویق می‌افتد.]
• ۲a. کاربر «انصراف از به‌روزرسانی» را انتخاب می‌کند:
  • ۲a1. دیالوگ بسته می‌شود و کاربر با نسخه فعلی به کارش ادامه می‌دهد — برخلاف به‌روزرسانی اجباری، اینجا محتوای صفحه پشت دیالوگ در دسترس است (BR-6).

پس‌شرط‌ها — یا نسخه تازه در حال نصب است، یا کاربر با نسخه فعلی به کارش ادامه می‌دهد.

---

سناریوی ۶: درخواست اجازه دسترسی به میکروفون

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

نقش‌های درگیر — همه کاربران.

پیش‌نیازها — کاربر جستجوی صوتی را در صفحه جستجو انتخاب کرده و اجازه میکروفون هنوز داده نشده است (BR-7).

جریان اصلی

۱. کاربر جستجوی صوتی را انتخاب می‌کند. → پیش از شروع ضبط، دیالوگ اجازه با پرسش «آیا به آپارات اجازه استفاده از میکروفون را می‌دهید ؟» و توضیح «شما بعدا می‌توانید این را از مسیر تنظیمات دستگاه > اپلیکیشن‌ها تغییر دهید.» نمایش داده می‌شود (BR-8)، با سه گزینه: «بله، حین استفاده از این اپلیکیشن»، «فقط این یک‌بار» و «اجازه نمی‌دهم».

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

جریان‌های جایگزین و استثنا

• ۲a. کاربر «فقط این یک‌بار» را انتخاب می‌کند:
  • ۲a1. ضبط برای همین بار شروع می‌شود؛ دفعه بعد که کاربر جستجوی صوتی را انتخاب کند، همین دیالوگ دوباره نمایش داده می‌شود.
• ۲b. کاربر «اجازه نمی‌دهم» را انتخاب می‌کند:
  • ۲b1. ضبط شروع نمی‌شود و کاربر روی صفحه جستجو می‌ماند؛ ورود متنی با کیبورد مجازی همچنان در دسترس است.
  • ۲b2. کاربر می‌تواند بعداً این تصمیم را از تنظیمات دستگاه تغییر دهد (BR-8).

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

پرسش‌های باز

• ۱۴۰۵/۰۵/۲۷ — رفتار پس از انتخاب «انصراف» در به‌روزرسانی اجباری (جریان جایگزین ۲a سناریوی ۴). — در انتظار تیم محصول.
• ۱۴۰۵/۰۵/۲۷ — رفتار شکست دانلود یا نصب به‌روزرسانی (جریان جایگزین ۲b سناریوی ۴). — در انتظار تیم محصول.
• ۱۴۰۵/۰۵/۲۷ — نمایش دیالوگ به‌روزرسانی اختیاری در حین پخش (جریان جایگزین ۱a سناریوی ۵). — در انتظار تیم محصول.
• ۱۴۰۵/۰۵/۲۷ — طراحی مشخص نمی‌کند دیالوگ به‌روزرسانی اختیاری هر چند وقت یک‌بار دوباره نمایش داده می‌شود اگر کاربر یک بار انصراف داده باشد. — در انتظار تیم محصول.

وابستگی‌ها و پیش‌نیازها

• سرویس بررسی نسخه که وجود و اجباری بودن نسخه تازه را تعیین می‌کند (سناریوهای ۴ و ۵).
• تنظیمات اجازه‌های دستگاه برای اجازه میکروفون (سناریوی ۶).

تاریخچه تغییرات

تاریخ	تغییر	منبع
۱۴۰۵/۰۵/۲۷	نسخه اولیه	طراحی Alerts & Errors - 1.0.0 + سند context محصول