در متنِ صوتی، نشانیِ خام، شکلِ نمایش و جمله‌ای که باید شنیده شود سه چیزند. اگر فقط بگوییم «لینکِ زیر را بزنید» اما مخاطب در یک تماسِ فقط‌صوتی است، مسیرِ اقدامِ روشنی نداده‌ایم. این راهنما چهار پیامِ اصیل و یک قراردادِ کنترلِ مقصد دارد؛ هیچ پیام یا صدایی واقعاً ارسال یا تولید نشده است.
یک مقصد، سه لایهٔمحتوا
در JSON همراه، raw_target رشتهٔمقصدِ مرجع، display نوشتهٔقابل‌دیدن و spoken متنِ پیشنهادیِ شنیدن است. نشانی‌ها همگی روی دامنهٔرزروشدهٔexample.com و صرفاًمثال‌اند. آن‌ها مقصدِ عملیاتیِ اپرا، ایمیلِ پشتیبانیِ واقعی یا لینکِ ارسالِ اطلاعاتِ شخصی نیستند.
برای مثال، مقصدِ راهنما https://example.com/Guide/A07?ref=Q9#step-2است، اما برچسبِ نمایش «راهنمای تنظیمات»می‌ماند. متنِ شنیدن ازکاربرِ صفحه می‌خواهد همان راهنمای همراه را باز کند. کوتاه‌شدنِ برچسبِ دیداری به معنی تغییرِ مسیرِ URL نیست؛ حروفِ مسیر، query و fragment دررشتهٔمرجع حفظ شده‌اند.
دو پیامِ فقط‌صوتی را مشخص‌تر بنویسیم
نمونهٔنشانیِ کوتاه example.com/start به‌صورت بخش‌بخش برای یادداشت‌کردن پیشنهاد شده وازمخاطب می‌خواهد دوباره بخواند. نمونهٔایمیل service.a07@example.com نیز بخشِ حرف، نقطه، صفر و عدد را ازهم جدا می‌کند. این پیشنهادِ متن است؛ خواندنِ واقعیِ موتور و فهمِ شنونده آزموده نشده‌اند.
تأییدِ بازخوانی در اینجا یک اقدامِ پیشنهادی برای آزمونِ محتواست، نه قابلیتِ اثبات‌شدهٔعاملِ تلفنی یا سامانهٔپیام‌رسانی. اگر خواندنِ نشانی در کاربردِ شما دشوار است، مسیرِ جایگزینِ واقعاًموجود را پیش ازوعده‌دادن طراحی کنید؛ ازنبودِ صفحه، پیامکِ خودکار اختراع نکنید.
صفر و علامت را بی‌اجازه حذف نکنیم
کدِ نمایشیِ نمونهٔچهارم R-007/A است. مقصدِ خامِ وب، همان شناسه را باقراردادِ مسیرِ آن مثال، به‌شکل R-007%2FA نگه می‌دارد. تابع، این رشته را ازروی جملهٔشنیداری بازسازی یا حدسی decode نمی‌کند. حذفِ دوصفر یاعوض‌کردنِ حرفِ مسیر ممکن است مقصد را تغییر دهد؛ این‌ها آرایشِ متن نیستند.
| نیاز | چه چیزی نگه داریم؟ |
|---|---|
| بازکردنِ صفحه | مقصدِ خامِ مرجع و برچسبِ نمایشِ روشن |
| یادداشتِ نشانیِ صوتی | بخش‌بندیِ پیشنهادی و آزمونِ بازخوانی |
| شناسهٔدارایِ صفر | صفرهایِ آغاز، حرف‌ها و علامت‌هایِ لازم |
| ادعایِ ارسال | فقط با شاهدِ واقعیِ تحویل؛ دراین‌نمونه نداریم |
کد دقیقاً چه چیزی را رد می‌کند؟
هر پیام باید مقصدی عینِ مرجعِ همان fixture داشته باشد. چهار تغییرِ غلط واقعاً آزموده شده‌اند: کوچک‌کردنِ حروفِ مسیر، حذفِ صفرهایِ شناسه، «لینکِ زیر»درکانالِ فقط‌صوتیِ بدونِ راهِ جایگزین و ادعایِ ارسال‌شدن با تحویلِ تأییدنشده. هیچ درخواستِ شبکه‌ای درکد نیست و رشتهٔJSON کنارِ آن، مرجعِ دستیِ خودِ تمرین است.
قبول‌شدنِ این تابع، هم‌معناییِ عمومیِ جمله و URL یا درست‌خوانده‌شدنِ آن را اثبات نمی‌کند؛ فقطبرابریِ رشتهٔمرجع وقراردادِ چندفیلد را می‌سنجد. برایهمین spoken را جدا بازبینی و روی صدایِ مجازِ واقعی درآینده آزمایش کنید. مقصدِ دقیق را با تبدیلِ حدسیِ کلمه‌هایی مانند«اسلش»نسازید.
این فایل را با چه درخواستی همراه کنیم؟
در آماده‌سازیِ متن برایِ گویندگی جمله‌بندی و ترتیبِ شنیدن را بررسی می‌کنیم؛ خروجیِ این‌صفحه حفظِ مقصد و قابل‌انجام‌بودنِ قدمِ بعد است. خواندنِ عدد و شناسه نیز برای صفرها و کدها کمک می‌کند. برای درخواستِ اپراگو نسخهٔخام، نمایش و شنیدن را کنارهم بدهید؛ این مطلب ارسالِ پیام، تشخیصِ نشانی یا کنترلِ تلفظِ اختصاصی درمحصول را اعلام نمی‌کند.
فایل تمرین و منبع
کنترلِ مقصدِ دقیق و ردِ اقدامِ ناممکن یا ادعایِ ارسالِ تأییدنشده · چهار پیامِ اصیل؛ مقصدِ خام، نمایش، متنِ شنیدن و اقدامِ بعد
- مرجع اصلی RFC3986؛ ساختارِ URI و اجزایِ مسیر، query و fragment
- مرجع اصلی RFC2606؛ دامنه‌هایِ رزروشدهٔمثال
منابع در ۳ نوامبر ۲۰۲۶ خوانده شدند؛ این تاریخ، تاریخ انتشار منبع نیست. مثال‌ها و فایل‌های این راهنما آموزشی و ساختهٔ تحریریه‌اند.