اگر از Styled Media Receiver استفاده می‌کنید یا درحال ساختن Custom Receiver هستید، باید برنامه‌تان را ثبت کنید. پس‌از ثبت برنامه، شناسه برنامه دریافت خواهید کرد که توسط برنامه فرستنده شما برای برقراری تماس‌های API، مانند راه‌اندازی برنامه «گیرنده وب»، استفاده می‌شود.
اگر از گیرنده رسانه پیش‌فرض استفاده می‌کنید، لازم نیست برنامه‌تان را ثبت کنید. «گیرنده رسانه پیش‌فرض» به شما اجازه نمی‌دهد هیچ سبکی به میانای کاربر پخش‌کننده رسانه ارائه دهید و از یک ثابت ارائه‌شده به‌عنوان شناسه برنامه استفاده می‌کند.
همچنین، باید دستگاه Google Cast خود را ثبت کنید تا بتواند قبل‌از انتشار برنامه «گیرنده وب» شما، به آن دسترسی داشته باشد. وقتی برنامه گیرنده را منتشر کردید، برای همه دستگاه‌های Google Cast دردسترس خواهد بود.
برنامه‌ها
ثبت کردن برنامه به شما امکان می‌دهد آن را قبل‌از انتشار برنامه، درمقابل دستگاه Cast ثبت‌شده‌تان آزمایش کنید. انتشار برنامه آن را برای همه دستگاه‌های Cast دردسترس قرار می‌دهد.
ثبت کردن برنامه
باید یک گیرنده رسانه سبک‌دار یا یک گیرنده سفارشی ثبت کنید تا شناسه برنامه‌ای را دریافت کنید که با تماس‌های API از برنامه فرستنده استفاده می‌شود.
برای ثبت برنامه Cast:
- به سیستم کنسول توسعه‌دهنده Google Cast SDK وارد شوید.
- از صفحه نمای کلی یا صفحه برنامه‌ها، روی افزودن برنامه جدید کلیک کنید.
نوع برنامه «گیرنده وب» را که استفاده خواهید کرد انتخاب کنید:
گیرنده سفارشی
اگر برنامه‌تان به مؤلفه‌های میانای کاربر یا الگوهای تعاملی نیاز دارد که توسط «گیرنده رسانه سبک‌دار» ارائه نمی‌شود، این گزینه را انتخاب کنید. اگر نوع محتوای شما در فهرست انواع رسانه پشتیبانی‌شده «گیرنده رسانه سبک‌دار» نباشد، ممکن است لازم باشد «گیرنده سفارشی» را انتخاب کنید.
توجه داشته باشید که این گزینه مستلزم این است که برنامه وب کاملی برای برنامه «گیرنده وب» بسازید.
برای جزئیات، برنامه گیرنده سفارشی را بخوانید.
Styled Media Receiver
اگر برنامه‌تان محتوای ویدیویی یا صوتی را بااستفاده از یکی از انواع رسانه پشتیبانی‌شده جاری‌سازی می‌کند و می‌خواهید میانای کاربری در تلویزیون ارائه دهید که از میانای کاربر پخش‌کننده رسانه پیش‌فرض یا مجموعه‌ای از سبک‌های سفارشی روی میانای کاربر پخش‌کننده رسانه پیش‌فرض استفاده می‌کند، این گزینه را انتخاب کنید.
سبک‌های سفارشی که ممکن است ارائه دهید به شما امکان می‌دهد ظاهر عناصر مختلف میانای کاربر پخش‌کننده (مانند صفحه اسپلش و نوار پیشرفت) را به‌سادگی با ارائه فایل CSS تعریف کنید—نیازی به ساختن برنامه گیرنده ندارید.
برای جزئیات، گیرنده رسانه سبک‌دار را بخوانید.
جزئیات برنامه «گیرنده وب» را وارد کنید:
در فیلد نام، نام برنامه‌تان را وارد کنید.
این نام برنامه است که هنگام بار شدن «گیرنده وب» یا در حالت غیرفعال (اگر از «گیرنده رسانه سبک‌دار» استفاده می‌کنید) نشان داده می‌شود. اگر از «گیرنده سفارشی» استفاده می‌کنید، مقدار این فیلد مقدار پیش‌فرض برای وضعیت برنامه است، اگر بااستفاده از روش
setApplicationStateتنظیم نشده باشد.ظاهر برنامه «گیرنده وب» را مشخص کنید:
برای گیرنده سفارشی، در فیلد نشانی وب، نشانی وب برنامه را مشخص کنید.
نشانی وبی را وارد کنید که دستگاه Google Cast باید هنگام بار کردن برنامه «گیرنده وب» شما درخواست کند. درطول توسعه، نشانی وب می‌تواند از HTTP استفاده کند اما وقتی برنامه منتشر می‌شود باید از HTTPS استفاده کند. نشانی وب ممکن است برای صفحه HTML یا نوع فایل دیگری باشد که از مرورگر وب قابل‌دسترسی است. اشکالی ندارد که «گیرنده وب» شما در نشانی IP داخلی (ثبت‌شده در NAT) باشد، اما نباید در localhost باشد، زیرا به‌ندرت دامنه سطح بالا است. اگرچه برنامه «گیرنده وب» هنگام انتشار باید ازطریق SSL (HTTPS) ارائه شود، محتوای بارشده در برنامه «گیرنده وب» ممکن است ازطریق HTTP ارائه شود.
برای گیرنده رسانه با سبک، در فیلد نشانی وب پوسته، نشانی وب برگه سبک را مشخص کنید.
نشانی وب HTTPS ارائه دهید که به فایل CSS شما واقع در وب‌سایت خودتان اشاره کند. برای استفاده از سبک‌های پیش‌فرض، فیلد را خالی بگذارید. اگر می‌خواهید سبک‌های سفارشی‌تان را ارائه یا به‌روز کنید، همیشه می‌توانید بعداً این مورد را ویرایش کنید.
چارگوش پشتیبانی از ارسال رله‌ای را علامت بزنید یا علامت آن را بردارید.
پخش رله‌ای به «گیرنده وب» شما امکان می‌دهد از پخش محتوا از فرستنده‌هایی که به همان شبکه Wi-Fi گیرنده متصل نیستند پشتیبانی کند. برای غیرفعال کردن پخش رله‌ای برای گیرنده، این چارگوش را لغو انتخاب کنید.
چارگوش پشتیبانی از ارسال محتوا به دستگاه‌های فقط صوتی را علامت بزنید یا علامت آن را بردارید.
برای اینکه به برنامه‌تان اجازه دهید Google Cast را برای دستگاه‌های صوتی پیدا کند، این چارگوش را علامت بزنید. برای غیرفعال کردن پشتیبانی از دستگاه‌های فقط صوتی، این چارگوش را لغو انتخاب کنید. برای اطلاعات بیشتر، به دستگاه‌های صوتی مراجعه کنید.
روی ذخیره کلیک کنید.
جزئیات ثبت‌نام شما، ازجمله شناسه، نام، نوع، و وضعیت درخواست نمایش داده می‌شود. شناسه برنامه را یادداشت کنید، زیرا باید آن را با تماس‌های Cast API برنامه‌تان ارائه دهید.
روی تمام کلیک کنید تا به صفحه «برنامه‌ها» برگردید.
ویرایش اطلاعات درخواست
قبل‌از اینکه بتوانید برنامه‌تان را منتشر کنید، باید اطلاعات بیشتری ارائه دهید. همچنین می‌توانید اطلاعاتی را که درطول ثبت‌نام درباره برنامه‌تان ارائه کرده‌اید به‌روز کنید.
برای ویرایش اطلاعات درخواست:
- در کنسول توسعه‌دهنده Google Cast SDK، از صفحه نمای کلی یا صفحه برنامه‌ها، روی شناسه برنامه کلیک کنید یا روی ویرایش برای برنامه‌ای که می‌خواهید ویرایش کنید کلیک کنید.
- در فیلد نام، نامی را که هنگام ثبت برنامه ارائه کرده‌اید به‌روز کنید.
- برای برنامه‌های «گیرنده سفارشی»، در فیلد نشانی وب، مکان برنامه «گیرنده وب» را که ثبت کرده‌اید به‌روز کنید.
- برای برنامه‌های «گیرنده سبک‌دار»، در فیلد نشانی وب پوسته، مکان برگه سبک برنامه‌تان را به‌روز کنید.
چارگوش پشتیبانی از ارسال رله‌ای را علامت بزنید یا علامت آن را بردارید.
پخش رله‌ای به «گیرنده وب» شما اجازه می‌دهد از فرستنده‌هایی که به همان شبکه Wi-Fi گیرنده متصل نیستند، پخش محتوا را پشتیبانی کند. برای غیرفعال کردن پخش رله‌ای برای گیرنده، این چارگوش را لغو انتخاب کنید.
چارگوش پشتیبانی از پخش محتوا در دستگاه‌های فقط صوتی را علامت بزنید یا علامت نزنید.
برای اینکه به برنامه‌تان اجازه دهید Google Cast را برای دستگاه‌های صوتی پیدا کند، این چارگوش را علامت بزنید. برای غیرفعال کردن پشتیبانی از دستگاه‌های فقط صوتی، این چارگوش را لغو انتخاب کنید. برای اطلاعات بیشتر، به دستگاه‌های صوتی مراجعه کنید.
در بخش جزئیات فرستنده، موارد زیر را برای هر پلاتفرمی که برنامه‌تان پشتیبانی می‌کند ارائه دهید:
Android:
- نام کاملاً واجدشرایط بسته برنامه شما.
iOS:
- شناسه iTunes و شناسه بسته ترکیبی که Apple درخواست کرده است.
- URI راه‌اندازی برنامه، بااستفاده از URI که برنامه Google Home برای راه‌اندازی برنامه‌تان استفاده می‌کند. برای اطلاعات بیشتر درباره قالب URI موردنیاز، استفاده از طرح‌واره‌های نشانی وب برای برقراری ارتباط با برنامه‌ها را ببینید.
وب:
- نشانی وب‌سایت برنامه‌تان.
در بخش جزئیات فهرستگان، انتخاب کنید که آیا برنامه‌تان در دارایی‌های Google مثل chromecast.com/apps فهرست شود یا نه.
از منوِ کرکره‌ای دسته، دسته‌ای را انتخاب کنید که به بهترین شکل برنامه‌تان را توصیف می‌کند.
توجه: برنامه‌تان باید از انواع رسانه شرح‌داده‌شده در اینجا و همچنین انواع رسانه مستتر در تنظیمات دیگر پشتیبانی کند. برای مثال، اگر برنامه‌تان از Google Cast برای صدا پشتیبانی می‌کند و در اینجا «تلویزیون و فیلم» را انتخاب می‌کنید، برنامه‌تان باید از دستگاه‌های فقط صوتی همان‌طور که در دستگاه‌های صوتی شرح داده شده است و همچنین از مقررات بازپخش ویدیو پشتیبانی کند.
برای توصیف کشورهایی که برنامه‌تان در آن‌ها دردسترس است، دکمه رادیویی همه کشورها یا فقط در کشورهای انتخاب‌شده را انتخاب کنید؛ اگر کشورها را مشخص می‌کنید، چارگوش‌های مربوط به آن کشورها را در فهرستی که ظاهر می‌شود علامت بزنید.
در فیلد عنوان، عنوان توصیفی برای برنامه‌تان ارائه دهید.
از ۵۰ نویسه یا کمتر استفاده کنید. برای مثال، «YouTube».
در فیلد شرح، شرحی برای برنامه‌تان وارد کنید.
از ۸۰ نویسه یا کمتر استفاده کنید. برای مثال، «از کانال‌های YouTube دلخواهتان در بهترین صفحه‌نمایش خانه لذت ببرید.»
در بخش گرافیک، روی علامت به‌علاوه کلیک کنید تا تصویر نماد برنامه‌تان را بارگذاری کنید.
تصویر باید ۵۱۲ در ۵۱۲ پیکسل باشد و می‌تواند پس‌زمینه شفاف داشته باشد.
در بخش ترجمه‌های خود را اضافه کنید، اگر می‌خواهید ترجمه‌هایی برای فیلدهای عنوان و توضیحات ارائه دهید، زبان موردنظر را از منو کرکره‌ای انتخاب کنید، روی افزودن کلیک کنید و متن ترجمه‌شده را در کادر گفتگویی که ظاهر می‌شود وارد کنید؛ همچنین می‌توانید تصویری برای نماد مختص آن ترجمه بارگذاری کنید.
وقتی به‌روزرسانی اطلاعات درخواستتان تمام شد، روی ذخیره کلیک کنید.
منتشر کردن برنامه
با انتشار برنامه‌تان، برنامه شما برای همه دستگاه‌های Cast در سراسر جهان دردسترس قرار می‌گیرد. همچنین فهرستی برای برنامه‌تان در دارایی‌های Google ایجاد می‌کند، مانند سایت فهرستگان chromecast.com/apps که کاربران می‌توانند برنامه شما را در آنجا پیدا و بارگیری کنند. اگر هنگام ویرایش اطلاعات برنامه در مرحله ۶ بالا، انتخاب کرده باشید که برنامه‌تان فهرست شود، پس‌از انتشار در chromecast.com/apps نشان داده خواهد شد.
برای انتشار برنامه:
در کنسول توسعه‌دهنده Google Cast SDK، از صفحه نمای کلی یا صفحه برنامه‌ها، برای برنامه‌ای که می‌خواهید منتشر کنید، روی انتشار کلیک کنید.
اگر اطلاعات برنامه‌تان کامل باشد، صفحه پیش‌نمایشی با اطلاعات برنامه‌ای که در ویرایش اطلاعات برنامه وارد کرده‌اید ظاهر می‌شود. اگر نه، پیامی ظاهر می‌شود که اطلاعاتی را که باید ارائه دهید ذکر می‌کند.
می‌توانید روی ویرایش کلیک کنید تا به عقب برگردید و اطلاعات را به‌روز کنید.
اگر برای انتشار برنامه‌تان آماده هستید، روی انتشار کلیک کنید.
آمار
کنسول برنامه‌نویس Google Cast SDK عملکرد برنامه شما را پیگیری می‌کند. برای هر برنامه منتشرشده در صفحه «برنامه‌ها» یا «نمای کلی»، می‌توانید با کلیک کردن روی مشاهده در ستون آمار، داده‌های عملکرد را ببینید.
اطلاعات زیر ارائه می‌شود:
- تعداد گیرنده‌های Cast که برنامه را راه‌اندازی کرده‌اند
- تعداد جلسه‌های راه‌اندازی‌شده
- میانگین زمان بازپخش رسانه (به دقیقه) در هر جلسه
اگر پلاتفرم دیگری در آمار ظاهر شود، به این معنی است که فرستنده پلاتفرم خود را مشخص نکرده است؛ برای مثال، اگر فرستنده iOS قدیمی‌تر به‌روزرسانی نشده باشد.
دستگاه‌ها
به‌طور پیش‌فرض، دستگاه‌های Google Cast (مثل Chromecast یا دستگاه Android TV) برای توسعه و آزمایش فعال نیستند. برای تبدیل دستگاهتان به دستگاه توسعه و دسترسی به برنامه «گیرنده وب» منتشرنشده‌تان درطول توسعه، باید دستگاه را در برنامه‌تان ثبت کنید. ثبت کردن همچنین به گیرنده اجازه می‌دهد از پنجره مرورگر ازراه‌دور برای اشکال‌زدایی قابل‌دسترسی باشد (اشکال‌زدایی را ببینید).
برای ثبت دستگاه Google Cast:
دستگاه Google Cast را راه‌اندازی کنید و آن را به همان شبکه Wi-Fi متصل کنید که رایانه‌تان به آن متصل است.
برای اطلاعات بیشتر، دستورالعمل‌های راه‌اندازی دستگاه Cast را ببینید.
در رایانه، مرورگر وب سازگار با Cast را باز کنید.
به سیستم کنسول توسعه‌دهنده Google Cast SDK وارد شوید.
شماره سریال دستگاهی را که می‌خواهید ثبت کنید پیدا کنید.
از صفحه «نمای کلی» یا صفحه «دستگاه‌ها»، روی افزودن دستگاه جدید کلیک کنید.
شماره سریال دستگاهتان را وارد کنید.
شرحی وارد کنید و روی تأیید کلیک کنید.
این فقط نامی آشنا برای دستگاهتان است (لازم نیست با نامی که درطول راه‌اندازی کاربر به دستگاه داده‌اید مطابقت داشته باشد).
پیش‌از ادامه دادن، پانزده دقیقه صبر کنید.
وقتی ثبت‌نام تکمیل شد، «وضعیت» دستگاه به «آماده برای آزمایش» تغییر می‌کند.
دستگاه Cast را بازراه‌اندازی کنید: کابل برق یا USB را از دستگاه جدا کنید، سپس آن را دوباره وصل کنید.
پیدا کردن شماره سریال دستگاه
برای پیدا کردن شماره سریال هر دستگاه، می‌توانید صفحه «کنسول توسعه‌دهنده Cast» را به دستگاه ارسال کنید:
روی دکمه «پخش محتوا» کلیک کنید (مثل اینکه می‌خواهید این صفحه را پخش کنید).
در پیام‌واره، برگه پخش محتوا نمایش داده می‌شود و دستگاه‌های دردسترس فهرست می‌شود.
از منوِ کرکره‌ای، دستگاهی را که می‌خواهید شماره سریال آن را دریافت کنید انتخاب کنید.
- برای دستگاه‌های نمایشگر، شماره سریال روی صفحه تلویزیون نمایش داده می‌شود و با صدای بلند از بلندگوهای تلویزیون خوانده می‌شود (برای کمک به رفع ابهام بین 0 و O).
- برای دستگاه‌های صوتی، شماره سریال با صدای بلند در بلندگویی که محتوا به آن ارسال می‌شود خوانده می‌شود.
شماره سریال نرم‌افزار Android TV
دستگاه‌های Android TV (ATV) چندین شماره سریال مرتبط با خود دارند. شماره سریال نرم‌افزار (Cast) را می‌توان ازطریق ارسال صفحه «کنسول توسعه‌دهنده Cast» به دستگاه ATV (همان‌طور که در بالا توضیح داده شد) یا با قرار دادن دستگاه ATV در حالت توسعه‌دهنده و جستجوی شماره سریال نرم‌افزار در تنظیمات Cast به‌دست آورد.
برای قرار دادن دستگاه ATV در حالت توسعه‌دهنده، به تنظیمات > سیستم > درباره > ساخت سیستم‌عامل Android TV بروید و چندبار روی ساخت کلیک کنید تا دستگاه به شما اطلاع دهد که در حالت توسعه‌دهنده هستید. برای پیدا کردن شماره سریال در حالت توسعه‌دهنده، بسته به مدل Android TV خود، به تنظیمات > اولویت‌های دستگاه > Google Cast یا تنظیمات > سیستم > Cast بروید تا شماره سریال نرم‌افزار را ببینید.
توجه داشته باشید که وقتی دستگاه ATV بازنشانی کارخانه‌ای می‌شود، شماره سریال نرم‌افزار تغییر خواهد کرد. پس‌از بازنشانی کارخانه‌ای، مراحل بالا را برای پیدا کردن شماره سریال نرم‌افزار دنبال کنید و شماره سریال نرم‌افزار جدید دستگاه را دوباره در «کنسول توسعه‌دهنده Cast» ثبت کنید.
مشکلات حساب
می‌خواهم ثبت‌نامم در «کنسول توسعه‌دهنده Google Cast» را لغو کنم
کارمزد ثبت‌نام حساب توسعه‌دهنده ۵ دلاری قابل‌استرداد نیست.
دیگر نمی‌توانم به «کنسول توسعه‌دهنده Google Cast» دسترسی داشته باشم
اگر قبلاً ایمیلی از ما دریافت کرده‌اید که در آن ذکر شده حساب توسعه‌دهنده شما به‌دلیل نقض مکرر شرایط خدمات یا خط‌مشی‌های محتوا ما تعلیق شده است، درصورت نیاز به توضیحات بیشتر به آن ایمیل پاسخ دهید.
برنامه من از Google Cast برداشته شده است
برنامه‌های برداشته‌شده به‌عنوان اخطار علیه خوش‌حسابی حساب توسعه‌دهنده شما محسوب می‌شوند. نقض‌های متعدد یا فاحش خط‌مشی ممکن است منجر به بسته شدن حساب توسعه‌دهنده شما شود.
برداشتن به این معنی است که کاربران نمی‌توانند برنامه برداشته‌شده را مشاهده کنند یا به آن دسترسی داشته باشند. اگر اطلاعات اعتباری توسعه‌دهنده شما همچنان نزد Google Cast خوش‌حساب است و ماهیت برنامه‌تان این امکان را فراهم می‌کند، می‌توانید اصلاحات لازم را انجام دهید و نمونه جدید و سازگاری برای برنامه‌تان منتشر کنید.
تا زمانی که نقض خط‌مشی برطرف نشده است، برنامه برداشته‌شده را دوباره منتشر نکنید.
می‌خواهم نشانی ایمیل منسوب به حسابم را تغییر دهم
نمی‌توانید نشانی ایمیل منسوب به «حساب توسعه‌دهنده Google Cast» خود را تغییر دهید. اگر برای سازمانی کار می‌کنید، توصیه می‌کنیم از نشانی ایمیل تیمی استفاده کنید تا در آینده با مشکل دسترسی مواجه نشوید.
مشکل دیگری دارم
لطفاً صفحه پشتیبانی Cast SDK را ببینید.