Đăng ký

Bạn phải đăng ký ứng dụng nếu đang sử dụng Trình thu nhận nội dung nghe nhìn đã tạo kiểu hoặc tạo Bộ thu tuỳ chỉnh. Sau khi đăng ký ứng dụng, bạn sẽ nhận được mã ứng dụng. Ứng dụng này sẽ được ứng dụng gửi của bạn dùng để thực hiện các lệnh gọi API, chẳng hạn như để chạy ứng dụng Trình nhận web.

Nếu sử dụng Default Media receiver (Bộ thu phương tiện mặc định), bạn không cần phải đăng ký ứng dụng. Trình nhận nội dung đa phương tiện mặc định không cho phép bạn cung cấp bất kỳ kiểu nào cho giao diện người dùng của trình phát nội dung đa phương tiện và sử dụng một hằng số đã cung cấp làm mã nhận dạng ứng dụng.

Ngoài ra, bạn phải đăng ký thiết bị Google Cast để thiết bị có thể truy cập vào ứng dụng Trình thu thập dữ liệu trên web trước khi xuất bản. Sau khi bạn phát hành ứng dụng bộ thu, ứng dụng này sẽ có cho tất cả thiết bị Google Cast.

Ứng dụng

Việc đăng ký ứng dụng cho phép bạn kiểm thử ứng dụng trên thiết bị Truyền đã đăng ký trước khi xuất bản ứng dụng. Việc phát hành ứng dụng sẽ cung cấp ứng dụng cho tất cả các Thiết bị truyền.

Đăng ký ứng dụng của bạn

Bạn phải đăng ký Trình nhận nội dung nghe nhìn đã tạo kiểu hoặc Trình nhận tuỳ chỉnh để nhận mã ứng dụng được sử dụng với các lệnh gọi API từ ứng dụng của người gửi.

Để đăng ký ứng dụng Truyền của bạn:

  1. Đăng nhập vào Google Cast SDK Developer Console.
  2. Trên trang Overview (Tổng quan) hoặc Ứng dụng (Ứng dụng), hãy nhấp vào Add New Application (Thêm ứng dụng mới).
  3. Chọn loại ứng dụng Trình thu web mà bạn sẽ sử dụng:

    • Bộ thu tuỳ chỉnh

      Chọn chế độ này nếu ứng dụng của bạn yêu cầu các thành phần giao diện người dùng hoặc mẫu tương tác không do Bộ thu nội dung nghe nhìn đã tạo kiểu cung cấp. Bạn cũng có thể cần chọn Trình thu thập tuỳ chỉnh nếu loại nội dung của bạn không được liệt kê là một trong các loại nội dung nghe nhìn được hỗ trợ của Trình nhận nội dung nghe nhìn được tạo kiểu.

      Xin lưu ý rằng tuỳ chọn này yêu cầu bạn tạo một ứng dụng web hoàn chỉnh cho ứng dụng Web receiver.

      Để biết thông tin chi tiết, hãy đọc bài viết Ứng dụng trình thu tuỳ chỉnh.

    • Bộ thu nội dung nghe nhìn đã tạo kiểu

      Chọn chế độ này nếu ứng dụng của bạn phát trực tuyến nội dung video hoặc âm thanh bằng một trong các loại nội dung nghe nhìn được hỗ trợ và bạn muốn cung cấp một giao diện người dùng trên TV sử dụng giao diện người dùng của trình phát nội dung đa phương tiện mặc định hoặc một tập hợp các kiểu tuỳ chỉnh ở trên giao diện người dùng của trình phát nội dung đa phương tiện mặc định.

      Với các kiểu tuỳ chỉnh mà bạn có thể cung cấp, bạn có thể xác định giao diện các thành phần khác nhau trên giao diện người dùng của trình phát (chẳng hạn như màn hình chờ và thanh tiến trình), chỉ cần cung cấp tệp CSS (bạn không cần tạo ứng dụng nhận).

      Để biết thông tin chi tiết, hãy đọc phần Bộ thu nội dung nghe nhìn đã tạo kiểu.

  4. Điền thông tin chi tiết cho ứng dụng Web receiver của bạn:

    1. Trong trường Name (Tên), hãy nhập tên ứng dụng.

      Đây là tên ứng dụng như xuất hiện khi Trình thu nhận web đang tải hoặc ở trạng thái rảnh nếu bạn đang sử dụng Bộ thu nội dung nghe nhìn được tạo kiểu. Nếu bạn đang sử dụng Trình nhận tuỳ chỉnh, thì giá trị của trường này sẽ là giá trị mặc định cho trạng thái ứng dụng nếu bạn không đặt trạng thái này bằng phương thức setApplicationState.

    2. Chỉ định giao diện của ứng dụng Web receiver:

      • Đối với Trình thu tuỳ chỉnh, trong trường URL, hãy chỉ định URL của ứng dụng.

        Nhập một URL mà thiết bị Google Cast sẽ yêu cầu khi tải ứng dụng Trình thu thập dữ liệu web của bạn. Trong quá trình phát triển, URL có thể sử dụng HTTP, nhưng khi ứng dụng được phát hành, URL đó phải sử dụng HTTPS. URL có thể là cho một trang HTML hoặc loại tệp khác có thể truy cập được từ trình duyệt web. Bạn có thể chấp nhận Web receiver của mình nằm trên địa chỉ IP nội bộ (đã đăng ký NAT), chứ không phải trên localhost, vì hiếm khi là miền cấp cao nhất. Mặc dù ứng dụng Trình thu nhận web phải được phân phát qua SSL (HTTPS) khi phát hành, nhưng nội dung được tải trên ứng dụng Trình thu web có thể được phân phát qua HTTP.

      • Đối với Bộ thu nội dung nghe nhìn đã tạo kiểu, trong trường URL giao diện, hãy chỉ định URL cho biểu định kiểu.

        Hãy cung cấp một URL loại HTTPS trỏ đến tệp CSS nằm trên trang web của riêng bạn. Để sử dụng kiểu mặc định, hãy để trống trường này. Bạn luôn có thể chỉnh sửa chế độ này sau nếu muốn cung cấp hoặc cập nhật kiểu tuỳ chỉnh.

      • Chọn hoặc bỏ chọn hộp kiểm Hỗ trợ truyền chuyển tiếp.

        Tính năng truyền chuyển tiếp cho phép Bộ thu web hỗ trợ truyền từ người gửi không được kết nối với cùng một mạng Wi-Fi với thiết bị nhận. Để tắt tính năng truyền chuyển tiếp cho thiết bị nhận, hãy bỏ đánh dấu hộp này.

      • Đánh dấu hoặc bỏ đánh dấu hộp Hỗ trợ truyền tới thiết bị chỉ phát âm thanh.

        Để cho phép ứng dụng của bạn khám phá Google Cast dành cho thiết bị âm thanh, hãy đánh dấu vào hộp này. Để tắt tính năng hỗ trợ các thiết bị chỉ phát âm thanh, hãy bỏ đánh dấu hộp này. Xem nội dung về Thiết bị âm thanh để biết thêm thông tin.

  5. Nhấp vào Lưu.

    Thông tin đăng ký của bạn, bao gồm cả mã nhận dạng, tên, loại và trạng thái của ứng dụng sẽ xuất hiện. Hãy ghi lại mã nhận dạng ứng dụng vì bạn sẽ cung cấp mã này cho các lệnh gọi Cast API (API Truyền) của ứng dụng.

  6. Nhấp vào Xong để quay lại trang Ứng dụng.

Chỉnh sửa thông tin về ứng dụng

Trước khi có thể phát hành ứng dụng, bạn phải cung cấp thêm một số thông tin. Bạn cũng có thể cập nhật thông tin mà bạn đã cung cấp về đơn đăng ký trong quá trình đăng ký.

Cách chỉnh sửa thông tin về đơn đăng ký:

  1. Trong Google Cast SDK Developer Console, trên trang Tổng quan hoặc trang Ứng dụng, hãy nhấp vào Mã ứng dụng hoặc nhấp vào Chỉnh sửa cho ứng dụng bạn muốn chỉnh sửa.
  2. Trong trường Name (Tên), hãy cập nhật tên mà bạn đã cung cấp khi đăng ký ứng dụng.
  3. Đối với các ứng dụng Trình thu tuỳ chỉnh, trong trường URL, hãy cập nhật vị trí của ứng dụng Trình thu nhận web mà bạn đã đăng ký.
  4. Đối với các ứng dụng Styled receiver, trong trường Skin URL (URL của giao diện), hãy cập nhật vị trí của biểu định kiểu của ứng dụng.
  5. Chọn hoặc bỏ chọn hộp kiểm Hỗ trợ truyền chuyển tiếp.

    Tính năng truyền chuyển tiếp cho phép Bộ thu web hỗ trợ truyền từ người gửi không được kết nối với cùng một mạng Wi-Fi như bộ thu. Để tắt tính năng truyền chuyển tiếp cho thiết bị nhận, hãy bỏ đánh dấu hộp này.

  6. Đánh dấu hoặc bỏ đánh dấu hộp Hỗ trợ truyền tới các thiết bị chỉ phát âm thanh.

    Để cho phép ứng dụng của bạn khám phá Google Cast dành cho thiết bị âm thanh, hãy chọn hộp này. Để tắt hỗ trợ cho các thiết bị chỉ phát âm thanh, hãy bỏ chọn hộp này. Xem nội dung Thiết bị âm thanh để biết thêm thông tin.

  7. Trong phần Thông tin chi tiết về người gửi, hãy cung cấp những thông tin sau cho từng nền tảng mà ứng dụng của bạn hỗ trợ:

    • Android:

      • tên đủ điều kiện của gói ứng dụng.
    • iOS:

    • Web:

      • URL của trang web cho ứng dụng của bạn.
  8. Trong phần Listing Details (Chi tiết trang thông tin), hãy chọn xem có liệt kê ứng dụng của bạn trên các sản phẩm của Google hay không, chẳng hạn như chromecast.com/apps.

  9. Từ trình đơn thả xuống Category (Danh mục), hãy chọn danh mục mô tả đúng nhất về ứng dụng của bạn.

    Lưu ý: Ứng dụng của bạn phải hỗ trợ các loại nội dung nghe nhìn được mô tả ở đây cũng như những loại được ngụ ý trong các chế độ cài đặt khác. Ví dụ: nếu ứng dụng của bạn hỗ trợ Google Cast cho âm thanh và bạn chọn TV và Phim ở đây, thì ứng dụng của bạn phải hỗ trợ các thiết bị chỉ phát âm thanh như mô tả trong phần Thiết bị âm thanh, cũng như các quy định về việc phát video.

  10. Để mô tả các quốc gia nơi bạn cung cấp ứng dụng, hãy chọn nút chọn All countries (Tất cả quốc gia) hoặc Only in selected countries (Chỉ các quốc gia được chọn); nếu chỉ định quốc gia, hãy đánh dấu vào ô cho các quốc gia đó trong danh sách xuất hiện.

  11. Trong trường Tiêu đề, hãy cung cấp tiêu đề mô tả cho ứng dụng của bạn.

    Bạn chỉ được dùng tối đa 50 ký tự. Ví dụ: "YouTube".

  12. Trong trường Mô tả, hãy nhập thông tin mô tả cho ứng dụng của bạn.

    Bạn chỉ được dùng tối đa 80 ký tự. Ví dụ: "Thưởng thức các kênh YouTube bạn yêu thích trên màn hình tốt nhất trong nhà".

  13. Trong phần Graphics (Đồ hoạ), hãy nhấp vào dấu cộng để tải hình ảnh biểu tượng lên cho ứng dụng.

    Hình ảnh phải có kích thước 512 X 512 pixel và có thể có nền trong suốt.

  14. Trong phần Add Your Own Translations (Thêm bản dịch của chính bạn), nếu bạn muốn cung cấp bản dịch cho các trường Title (Tiêu đề) và Description (Mô tả), hãy chọn ngôn ngữ trong trình đơn thả xuống, nhấp vào Add (Thêm) rồi nhập văn bản đã dịch vào hộp thoại xuất hiện; bạn cũng có thể tải lên hình ảnh cho biểu tượng dành riêng cho bản dịch đó.

  15. Khi bạn cập nhật xong thông tin về đơn đăng ký, hãy nhấp vào Lưu.

Xuất bản ứng dụng

Khi phát hành ứng dụng, bạn có thể cung cấp ứng dụng của mình cho tất cả các Thiết bị truyền trên toàn thế giới. Thao tác này cũng tạo một trang thông tin cho ứng dụng của bạn trên các thuộc tính của Google, chẳng hạn như trang web danh sách chromecast.com/apps, nơi người dùng có thể khám phá và tải ứng dụng của bạn xuống. Nếu bạn đã chọn liệt kê ứng dụng khi chỉnh sửa thông tin ứng dụng ở bước 6 ở trên, ứng dụng sẽ xuất hiện trên chromecast.com/apps sau khi xuất bản.

Cách xuất bản ứng dụng:

  1. Trong Google Cast SDK Developer Console, trên trang Tổng quan hoặc trang Ứng dụng, đối với ứng dụng bạn muốn phát hành, hãy nhấp vào Phát hành.

    Nếu thông tin ứng dụng của bạn đã hoàn chỉnh, màn hình xem trước sẽ xuất hiện cùng với thông tin ứng dụng mà bạn đã nhập vào phần Edit application information (Chỉnh sửa thông tin ứng dụng). Nếu không, một thông báo sẽ xuất hiện trích dẫn thông tin bạn cần cung cấp.

  2. Bạn có thể nhấp vào Chỉnh sửa để quay lại và cập nhật mọi thông tin.

  3. Khi bạn đã sẵn sàng xuất bản ứng dụng, hãy nhấp vào Xuất bản.

Số liệu thống kê

Google Cast SDK Developer Console giúp bạn theo dõi hiệu suất của ứng dụng. Đối với mỗi ứng dụng đã phát hành trong trang Ứng dụng hoặc Tổng quan, bạn có thể xem dữ liệu hiệu suất bằng cách nhấp vào Xem trong cột Thống kê.

Các thông tin sau đây được trình bày:

  • Số bộ thu Cast đã khởi chạy ứng dụng
  • Số phiên hoạt động đã diễn ra
  • Thời gian phát lại trung bình nội dung đa phương tiện (tính bằng phút) trên mỗi phiên

Nếu một nền tảng Other (Khác) xuất hiện trong số liệu thống kê, thì điều đó có nghĩa là người gửi chưa cho biết nền tảng đó; ví dụ: nếu một người gửi cũ trên iOS chưa được cập nhật.

Thiết bị

Theo mặc định, các thiết bị Google Cast (chẳng hạn như Chromecast hoặc thiết bị Android TV) không được bật để phát triển và kiểm thử. Để biến thiết bị của bạn thành một thiết bị phát triển và có quyền truy cập vào ứng dụng Web receiver chưa được phát hành trong quá trình phát triển, bạn phải đăng ký thiết bị với ứng dụng của mình. Việc đăng ký cũng cho phép truy cập receiver từ cửa sổ trình duyệt từ xa để gỡ lỗi (xem phần Gỡ lỗi).

Để đăng ký thiết bị Google Cast của bạn:

  1. Thiết lập thiết bị Google Cast và kết nối thiết bị này với cùng một mạng Wi-Fi như máy tính của bạn.

    Xem hướng dẫn Thiết lập thiết bị truyền để biết thêm thông tin.

  2. Trên máy tính, hãy mở một trình duyệt web được hỗ trợ tính năng Truyền.

  3. Đăng nhập vào Google Cast SDK Developer Console.

  4. Tìm số sê-ri của thiết bị bạn muốn đăng ký.

  5. Trên trang Tổng quan hoặc trang Thiết bị, hãy nhấp vào Thêm thiết bị mới.

  6. Nhập số sê-ri của thiết bị.

  7. Nhập nội dung mô tả rồi nhấp vào OK.

    Đây chỉ là tên thân thiện cho thiết bị của bạn (không cần khớp với tên bạn đã đặt cho thiết bị trong quá trình thiết lập người dùng).

  8. Chờ 15 phút trước khi tiếp tục.

    Sau khi đăng ký xong, Trạng thái của thiết bị sẽ là "Sẵn sàng để thử nghiệm".

  9. Khởi động lại Thiết bị truyền của bạn: ngắt kết nối nguồn hoặc cáp USB khỏi thiết bị, sau đó kết nối lại.

Tìm số sê-ri của thiết bị

Để tìm số sê-ri của bất kỳ thiết bị nào, bạn có thể truyền trang Cast Developer Console tới thiết bị:

  1. Nhấp vào nút Truyền (như thể bạn đang truyền trang này).

    Lời nhắc sẽ hiện Truyền thẻ và liệt kê các thiết bị có sẵn.

  2. Trên trình đơn thả xuống, hãy chọn thiết bị bạn muốn lấy số sê-ri.

    • Đối với thiết bị hiển thị, số sê-ri sẽ hiển thị trên màn hình TV và được đọc to trên loa TV (để giúp phân biệt giữa 0 và O).
    • Đối với các thiết bị âm thanh, số sê-ri sẽ được đọc to trên loa được truyền đến.

Số sê-ri của phần mềm Android TV

Các thiết bị Android TV (ATV) có nhiều số sê-ri liên kết với chúng. Bạn có thể lấy số sê-ri của phần mềm (Cast) bằng cách truyền trang Cast Developer Console tới thiết bị ATV như đã nêu ở trên hoặc bằng cách đặt thiết bị ATV ở chế độ nhà phát triển và tìm số sê-ri của phần mềm trong phần Cài đặt Cast.

Để đặt thiết bị ATV ở chế độ nhà phát triển, hãy chuyển đến phần Cài đặt > Hệ thống > Giới thiệu > Bản dựng hệ điều hành Android TV rồi nhấp vào bản dựng vài lần cho đến khi thiết bị thông báo rằng bạn đang ở chế độ nhà phát triển. Để tìm số sê-ri khi ở chế độ nhà phát triển, hãy chuyển đến phần Cài đặt > Lựa chọn ưu tiên về thiết bị > Tích hợp Chromecast hoặc Cài đặt > Hệ thống > Truyền, tuỳ thuộc vào mẫu ATV của bạn và bạn sẽ thấy số sê-ri của phần mềm hiển thị.

Lưu ý rằng khi thiết bị ATV được đặt lại về trạng thái ban đầu, số sê-ri của phần mềm sẽ thay đổi. Sau khi đặt lại về trạng thái ban đầu, hãy làm theo các bước ở trên để tìm số sê-ri của phần mềm và đăng ký lại số sê-ri phần mềm mới của thiết bị bằng Cast Developer Console.

Các vấn đề về tài khoản

Tôi muốn hủy đăng ký Bảng điều khiển dành cho nhà phát triển Google Cast của mình

Phí đăng ký tài khoản nhà phát triển 5 USD là phí không hoàn lại.

Tôi không thể truy cập vào Google Cast Developer Console nữa

Nếu bạn từng nhận được email của chúng tôi cho biết rằng tài khoản nhà phát triển của bạn đã bị tạm ngưng do nhiều lần vi phạm Điều khoản dịch vụ hoặc Chính sách nội dung của chúng tôi, hãy trả lời email đó nếu bạn cần biết thêm thông tin.

Ứng dụng của tôi đã bị xóa khỏi Google Cast

Nếu bị xoá, ứng dụng sẽ được tính là cảnh cáo về trạng thái không tốt của tài khoản nhà phát triển của bạn. Việc vi phạm chính sách nhiều lần hoặc nghiêm trọng có thể khiến tài khoản nhà phát triển của bạn bị chấm dứt.

Việc xoá có nghĩa là người dùng sẽ không thể xem hoặc truy cập vào ứng dụng đã bị xoá. Nếu thông tin đăng nhập dành cho nhà phát triển của bạn vẫn ở trạng thái tốt với Google Cast và bản chất của ứng dụng cho phép điều đó, bạn có thể sửa đổi và xuất bản một phiên bản ứng dụng tuân thủ mới.

Không phát hành lại ứng dụng đã bị xoá cho đến khi lỗi vi phạm chính sách được khắc phục.

Tôi muốn thay đổi địa chỉ email được liên kết với tài khoản của mình

Bạn không thể thay đổi địa chỉ email được liên kết với Tài khoản nhà phát triển Google Cast của mình. Nếu làm việc cho một tổ chức, bạn nên sử dụng địa chỉ email của nhóm để tránh các vấn đề khi truy cập trong tương lai.

Tôi có một vấn đề khác

Vui lòng xem trang hỗ trợ Cast SDK.