Đăng ký

Bạn phải đăng ký ứng dụng của mình nếu đang sử dụng Trình nhận nội dung nghe nhìn được tạo kiểu hoặc tạo Trình nhận tuỳ chỉnh. Sau khi đăng ký ứng dụng, bạn sẽ nhận được mã ứng dụng. Mã này được ứng dụng của người gửi 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 Trình thu nhận nội dung nghe nhìn mặc định, bạn không cần phải đăng ký ứng dụng của mình. Trình nhận nội dung nghe nhì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 trình phát nội dung đa phương tiện mà dùng một hằng số được cung cấp làm mã ứ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 nhận web trước khi phát hành. Sau khi bạn phát hành ứng dụng nhận, ứng dụng đó sẽ có trên tất cả cá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. Khi xuất bản, ứng dụng sẽ hiển thị cho tất cả Thiết bị truyền.

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

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

Cách đăng ký ứng dụng Truyền:

  1. Đăng nhập vào Google Cast SDK Developer Console.
  2. Từ trang Overview (Tổng quan) hoặc trang Applications (Ứ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 nhận web bạn sẽ sử dụng:

    • Bộ thu tuỳ chỉnh

      Chọn tuỳ chọn 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 các mẫu tương tác không phải do Trình thu nhận nội dung nghe nhìn được tạo kiểu cung cấp. Bạn cũng có thể cần chọn Trình thu 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 đa phương tiện được hỗ trợ của Trình thu nội dung đa phương tiệ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 được tạo kiểu

      Chọn lựa chọn này nếu ứng dụng của bạn truyền 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 trình phát nội dung nghe nhìn mặc định hoặc tập hợp các kiểu tuỳ chỉnh ở đầu giao diện người dùng trình phát nội dung nghe nhìn mặc định.

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

      Để biết thông tin chi tiết, hãy đọc bài viết Bộ nhận nội dung nghe nhìn được tạo kiểu.

  4. Điền thông tin chi tiết về ứng dụng Web receiver:

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

      Đây là tên ứng dụng như khi Trình nhận web đang tải hoặc ở trạng thái rảnh nếu bạn đang sử dụng Trình thu nhận nội dung nghe nhìn được tạo kiểu. Nếu bạn đang sử dụng Custom Collectr (Trình thu 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 không được đặt bằng phương thức setApplicationState.

    2. Chỉ định giao diện của ứng dụng Trình nhận web:

      • Đối với Custom receiver (Bộ thu tuỳ chỉnh), hãy chỉ định URL ứng dụng trong trường URL.

        Nhập URL mà thiết bị Google Cast sẽ yêu cầu khi tải ứng dụng Trình nhận web. Trong quá trình phát triển, URL có thể sử dụng HTTP nhưng khi xuất bản ứng dụng phải sử dụng HTTPS. URL này có thể dành 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. Có thể kết nối Trình thu nhận web của bạn trên địa chỉ IP nội bộ (đã đăng ký NAT), nhưng không phải trên máy chủ cục bộ, vì hiếm khi đó là miền cấp cao nhất. Mặc dù khi phát hành ứng dụng Trình nhận web phải được phân phát qua SSL (HTTPS), nhưng nội dung tải trên ứng dụng Trình nhận web có thể được phân phát qua HTTP.

      • Đối với Styled Media receiver (Trình thu nhận nội dung đa phương tiện được tạo kiểu), trong trường Skin URL (URL giao diện), hãy chỉ định URL cho biểu định kiểu.

        Cung cấp một URL loại HTTPS trỏ đến tệp CSS 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 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 Trình thu phát web hỗ trợ tính năng 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 bộ thu. Để tắt tính năng truyền chuyển tiếp cho receiver, 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ỉ âm thanh.

        Để cho phép ứng dụng của bạn khám phá Google Cast cho thiết bị âm thanh, hãy chọn 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. Hãy xem bài viết 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ã ứng dụng, tên, loại và trạng thái sẽ xuất hiện. Ghi lại mã ứng dụng vì bạn sẽ cung cấp mã này cùng với lệnh gọi Cast API của ứng dụng.

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

Chỉnh sửa thông tin ứ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ình đã cung cấp về đơn đăng ký trong quá trình đăng ký.

Để chỉnh sửa thông tin đăng ký:

  1. Trong Google Cast SDK Developer Console, từ trang Tổng quan hoặc trang Ứng dụng, hãy nhấp vào ID ứ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 nhận web mà bạn đã đăng ký.
  4. Đối với các ứng dụng Styled receiver (Trình tạo kiểu), 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ộ nhận web hỗ trợ tính năng truyền từ các bên gửi không được kết nối với cùng một mạng Wi-Fi với bộ thu. Để tắt tính năng truyền chuyển tiếp cho receiver, 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 thiết bị chỉ có âm thanh.

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

  7. Trong phần Sender Details (Thông tin về người gửi), hãy cung cấp 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:

      • Mã iTunesMã gói do Apple yêu cầu.
      • URI khởi chạy ứng dụng, bằng cách sử dụng URI mà ứng dụng Google Home dùng để chạy ứng dụng của bạn. Để biết thêm thông tin về định dạng URI bắt buộc, hãy xem nội dung Sử dụng lược đồ URL để giao tiếp với ứng dụng.
    • Web:

      • URL của trang web cho ứng dụng của bạn.
  8. Trong phần Listing Details (Chi tiết về danh sách), 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. Trong 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ư các loại nội dung nghe nhìn đượ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 đó phải hỗ trợ các thiết bị chỉ phát âm thanh như mô tả trong Thiết bị âm thanh, cũng như các quy định về phát video.

  10. Để mô tả các quốc gia mà ứng dụng của bạn được phân phối, hãy chọn nút chọn Tất cả các quốc gia hoặc Chỉ ở các quốc gia được chọn; nếu bạn chỉ định các quốc gia, hãy đánh dấu vào hộp 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 đề mang tính 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 nội dung mô tả cho ứng dụng.

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

  13. Trong phần Đồ 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 của bạn.

    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 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 Tiêu đềMô tả, hãy chọn ngôn ngữ từ trình đơn thả xuống, nhấp vào Thêm rồi nhập văn bản đã dịch vào hộp thoại vừa xuất hiện; bạn cũng có thể tải hình ảnh lên 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 đăng ký, hãy nhấp vào Lưu.

Xuất bản ứng dụng

Việc phát hành ứng dụng giúp cung cấp ứng dụng đó cho tất cả các thiết bị Truyền trên toàn thế giới. Trình quản lý này cũng tạo một danh sách cho ứng dụng của bạn trên các sản phẩm của Google, chẳng hạn như trang thông tin chromecast.com/apps, nơi người dùng có thể khám phá và tải ứng dụng xuống. Nếu bạn đã chọn liệt kê ứng dụng của mình khi chỉnh sửa thông tin ứng dụng ở bước 6 ở trên, thì ứng dụng đó sẽ xuất hiện trên chromecast.com/apps sau khi được 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 Xuất bản.

    Nếu thông tin ứng dụng đã hoàn tất, màn hình xem trước sẽ xuất hiện cùng với thông tin ứng dụng bạn đã nhập trong 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 bất kỳ thông tin nào.

  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 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ê.

Phần này bao gồm các thông tin sau:

  • Số bộ thu Cast đã chạy ứng dụng
  • Số phiên đã bắt đầu
  • Thời gian phát nội dung nghe nhìn trung bình (tính bằng phút) trên mỗi phiên

Nếu nền tảng 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ụ: người gửi iOS cũ hơn 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 Trình thu phát web chưa 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 người nhận truy cập từ một cửa sổ trình duyệt từ xa để gỡ lỗi (xem phần Gỡ lỗi).

Cách đăng ký thiết bị Google Cast:

  1. Thiết lập thiết bị Google Cast rồi kết nối thiết bị này với cùng một mạng Wi-Fi với 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ở trình duyệt web hỗ trợ Cast.

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

  4. Tìm số sê-ri của thiết bị mà 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. Hãy đợi 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 để kiểm thử".

  9. Khởi động lại thiết bị truyề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 một thiết bị bất kỳ, bạn có thể truyền trang Bảng điều khiển dành cho nhà phát triển của Cast 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 thẻ Truyền 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ị mà bạn muốn lấy số sê-ri.

    • Đối với các thiết bị hiển thị, số sê-ri hiển thị trên màn hình TV và được đọc to trên loa TV (để giúp phân biệt 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 liên kết với nhiều số sê-ri. Bạn có thể lấy số sê-ri của phần mềm (Truyền) bằng cách truyền trang Bảng điều khiển dành cho nhà phát triển của Cast sang thiết bị ATV như đã nêu ở trên hoặc bằng cách đặt thiết bị ATV sang 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.

Để đưa thiết bị ATV của bạn vào 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 một lần ở 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ị > Chromecast Tích hợp hoặc Cài đặt > Hệ thống > Truyền (tuỳ thuộc vào mẫu ATV của bạn). Bạn sẽ thấy số sê-ri của phần mềm hiển thị.

Xin lưu ý rằng khi đặt lại thiết bị ATV 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 là 5 USD không thể hoàn lại.

Tôi không còn truy cập được vào Bảng điều khiển dành cho nhà phát triển của Google Cast 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 được giải thích thêm.

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

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

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 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 sử dụng, bạn có thể sửa đổi và phát hành một phiên bản mới tuân thủ của ứng dụng.

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

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

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 sự cố truy cập sau này.

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

Vui lòng xem trang hỗ trợ Truyền SDK.