فایل صوتی با طول نامعلوم: به‌جای زمان تخمینی، وضعیت واقعی نشان دهید

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

برای نیلوفر، توسعه‌دهنده رابط سرویس تبدیل صوت به متن، راه‌حل این است: تا وقتی مبنای قابل‌اتکایی برای پیش‌بینی ندارید، زمان باقی‌مانده نشان ندهید. به‌جای «۳۰ ثانیه تا پایان»، بنویسید «در حال تبدیل صوت — ۳۰ ثانیه از شروع درخواست گذشته؛ زمان باقی‌مانده مشخص نیست». نتیجه عملی، رابطی است که وضعیت قابل‌مشاهده را گزارش می‌کند، نه وعده‌ای که داده‌ای پشت آن نیست.

سه کمیت را از هم جدا کنید

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

برای انتقال فایل، اگر تعداد بایت کل و منتقل‌شده واقعاً در دسترس است، درصد همان مرحله را نشان دهید. در API رویداد پیشرفت مرورگر، lengthComputable مشخص می‌کند که پیشرفت قابل‌محاسبه هست یا نه؛ این ویژگی، مجوز تخمین پردازش سمت سرور نیست. برچسب باید دقیقاً «انتقال فایل: ۶۰٪» باشد، نه «انجام کار: ۶۰٪». رسیدن انتقال به ۱۰۰٪ فقط یعنی انتقال تمام شده است.

قرارداد نمایش: مرحله قطعی، زمان سپری‌شده، پایان تأییدشده

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

برای پردازش بدون مخرج معلوم، نشانگر نامعین همراه متن وضعیت کافی است. مطابق مشخصات WAI-ARIA، وقتی مقدار پیشرفت نامعلوم است، aria-valuenow را روی progressbar نگذارید؛ مقدار ساختگی ۹۰ معنای عددی نادرستی به فناوری کمکی می‌دهد. متن وضعیت را در دسترس نگه دارید، اما کرنومتر ثانیه‌به‌ثانیه را با اعلان زنده مداوم برای کاربر صفحه‌خوان نخوانید.

نمونه اجرایی: تبدیل رویداد به متن صادقانه

کد زیر را در status.py ذخیره کنید. ورودی، آرایه‌ای از رویدادهای JSON است و خروجی، متن هر وضعیت. برای تکرارپذیری آزمایش، elapsed زمان سپری‌شده از شروع درخواست را به ثانیه می‌گیرد؛ در محصول واقعی این مقدار را در لایه مورداعتماد از ساعت یکنواخت بسازید. مقدار total در این مثال فقط کل بایت‌های انتقال است، نه طول صوت.

```python
import json
import sys

LABELS = {
'uploading': 'در حال انتقال فایل',
'queued': 'در صف پردازش',
'processing': 'در حال تبدیل صوت',
}

def render(event):
stage = event['stage']
elapsed = int(event['elapsed'])
if elapsed < 0:
raise ValueError('elapsed must be non-negative')
if stage == 'done':
return f'تبدیل کامل شد — {elapsed} ثانیه از شروع درخواست'
if stage == 'error':
return f'تبدیل ناموفق بود — {elapsed} ثانیه از شروع درخواست'
if stage not in LABELS:
raise ValueError('unknown stage')
label = LABELS[stage]
if stage == 'uploading':
total = event.get('total')
loaded = event.get('loaded')
if total is not None and loaded is not None:
if total <= 0 or not 0 <= loaded <= total:
raise ValueError('invalid byte counts')
percent = int(100 * loaded / total)
label += f': {percent}٪'
return (
f'{label} — {elapsed} ثانیه از شروع درخواست؛ '
'زمان باقی‌مانده مشخص نیست'
)

for event in json.load(sys.stdin):
print(render(event))
```

فرمان زیر هم ورودی نمونه را می‌سازد و هم برنامه را اجرا می‌کند. رویداد دوم عمداً هیچ درصدی ندارد؛ رویداد سوم نیز فقط به‌دلیل دریافت done پایان را اعلام می‌کند، نه به‌دلیل عبور زمان از یک آستانه.

```bash
cat > events.json <<'JSON'
[
{"stage": "uploading", "elapsed": 4, "loaded": 600, "total": 1000},
{"stage": "processing", "elapsed": 18},
{"stage": "done", "elapsed": 47}
]
JSON
python3 status.py < events.json
```

```other
در حال انتقال فایل: 60٪ — 4 ثانیه از شروع درخواست؛ زمان باقی‌مانده مشخص نیست
در حال تبدیل صوت — 18 ثانیه از شروع درخواست؛ زمان باقی‌مانده مشخص نیست
تبدیل کامل شد — 47 ثانیه از شروع درخواست
```

کجا این راه‌حل کافی نیست؟

خرابی مهم این است که اتصال وضعیت قطع شود ولی کرنومتر همچنان حرکت کند. حرکت کرنومتر اثبات فعالیت سرور نیست. وضعیت اتصال را جداگانه نگه دارید و هنگام قطع تأییدشده بنویسید «ارتباط دریافت وضعیت قطع شده؛ نتیجه پردازش هنوز مشخص نیست». نه موفقیت اعلام کنید و نه شکست پردازش؛ پس از اتصال مجدد، وضعیت همان کار را از سرور استعلام کنید.

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

منابع

MDN — ProgressEvent: lengthComputable property
https://developer.mozilla.org/en-US/docs/Web/API/ProgressEvent/lengthComputable

WAI-ARIA 1.2 — progressbar role
https://www.w3.org/TR/wai-aria-1.2/#progressbar

Python documentation — time.monotonic
https://docs.python.org/3/library/time.html#time.monotonic

No comments yet