chrome. truyền. Phiên
Mô tả trạng thái của ứng dụng Truyền hiện đang chạy. Thông thường, ứng dụng không được tạo các đối tượng này.
Hàm dựng
Phiên hoạt động
mới Phiên(sessionId, appId, displayName, appImages, receiver)
Thông số |
|
---|---|
sessionId |
string Giá trị nhận dạng phiên. |
appId |
string Mã nhận dạng ứng dụng của người nhận. |
displayName |
string Tên hiển thị của ứng dụng. |
appImages |
Mảng chrome.cast.Image khác rỗng Hình ảnh liên kết với ứng dụng. Giá trị không được rỗng. |
người nhận |
Trình thu nhận đang chạy ứng dụng. Giá trị không được rỗng. |
Thuộc tính
appId
string
Giá trị nhận dạng của ứng dụng Truyền. Không dành cho màn hình.
appImages
Mảng không có giá trị null của chrome.cast.Image không có giá trị null
Loạt hình ảnh có sẵn mô tả ứng dụng.
displayName
string
Tên mà con người có thể đọc được của ứng dụng Truyền, ví dụ: "YouTube".
truyền-thông
Mảng không có giá trị null chrome.cast.media.Media không có giá trị null
Nội dung nghe nhìn thuộc về phiên Truyền này, bao gồm cả những nội dung do người gửi khác tải.
không gian tên
mảng không rỗng của {name: string}
Danh sách không gian tên mà ứng dụng nhận hỗ trợ.
người nhận
chrome.cast.Receiver có giá trị rỗng
Bộ nhận đang chạy ứng dụng.
senderApps
Mảng không có giá trị null của chrome.cast.SenderApplication không có giá trị null
Các ứng dụng của người gửi được ứng dụng nhận hỗ trợ. Thông tin này có thể được dùng để nhắc người dùng cài đặt hoặc truy cập ứng dụng của người gửi.
sessionId
string
Xác định duy nhất phiên bản này của ứng dụng nhận.
trạng thái
chrome.cast.SessionStatus không có giá trị null
Trạng thái của phiên Truyền này đến ứng dụng nhận.
statusText
chuỗi có tính chất rỗng
Văn bản mô tả cho nội dung ứng dụng hiện tại, ví dụ: "Trình chiếu đám cưới của tôi".
transportId
string
Giá trị nhận dạng mô tả duy nhất phiên này cho mục đích truyền tải. Đây là kênh nội bộ của kênh liên lạc.
Phương thức
addMediaListener
addMediaListener(listener)
Thêm trình nghe được gọi khi một phiên phát nội dung đa phương tiện do một người gửi khác tạo.
Thông số |
|
---|---|
trình nghe |
function(non-null chrome.cast.media.Media) Trình nghe để thêm. |
addMessageListener
addMessageListener(namespace, listener)
Thêm trình nghe được gọi khi nhận được thông báo từ ứng dụng nhận. Trình nghe được gọi bằng không gian tên làm đối số đầu tiên và thông báo làm đối số thứ hai.
Thông số |
|
---|---|
vùng chứa tên |
string Không gian tên cần nghe, ví dụ: 'urn:x-cast:com.example.namespace'. |
trình nghe |
hàm(chuỗi, chuỗi) Trình nghe để thêm. |
addUpdateListener
addUpdateListener(listener)
Thêm trình nghe được gọi khi Phiên thay đổi. Các thay đổi đối với các thuộc tính sau sẽ kích hoạt trình nghe: statusText, không gian tên, trạng thái và âm lượng của trình thu nhận.
Trình nghe nên kiểm tra thuộc tính status
của Phiên để xác định trạng thái kết nối của Phiên. Ngừng sử dụng tham số boolean isAlive
và thay bằng thuộc tính Phiên status
. Tham số isAlive
vẫn được truyền vào để có khả năng tương thích ngược và có giá trị là true trừ phi status =
chrome.cast.SessionStatus.STOPPED
.
Thông số |
|
---|---|
trình nghe |
function(boolean) Trình nghe để thêm. |
getDialAppInfo
getDialAppInfo(successCallback, errorCallback)
Lấy thông tin ứng dụng DIAL.
Thông số |
|
---|---|
successCallback |
function(non-null chrome.cast.DialLaunchData) |
errorCallback |
function(non-null chrome.cast.Error) |
khởi hành
rời khỏi(thành côngCallback, lỗiCallback)
Rời khỏi (ngắt kết nối) khỏi ứng dụng nhận đang chạy được liên kết với phiên.
Các ứng dụng hiện tại trong phạm vi mà AutoJoinPolicy của khách hàng này xác định sẽ bị ngắt kết nối. Những khách hàng trong tương lai sẽ không tự động tham gia phiên đã rời khỏi.
Tất cả ứng dụng đã ngắt kết nối sẽ được gọi trình nghe cập nhật phiên bằng isAlive = true
. Trình nghe nên kiểm tra thuộc tính status
của Phiên để xác định trạng thái kết nối vì isAlive
không còn được dùng nữa. Trong trường hợp này,
status = chrome.cast.SessionStatus.DISCONNECTED
.
Thông số |
|
---|---|
successCallback |
hàm() |
errorCallback |
function(non-null chrome.cast.Error) Các lỗi có thể xảy ra là TIMEOUT, API_NOT_WITHINIZED, CHANNEL_ERROR, SESSION_ERROR và EXTENSION_DEFAULT. |
loadMedia
loadMedia(loadRequest, successCallback, errorCallback)
Tải nội dung nghe nhìn vào ứng dụng receiver đang chạy.
Thông số |
|
---|---|
loadRequest |
Yêu cầu tải nội dung nghe nhìn. Giá trị không được rỗng. |
successCallback |
function(non-null chrome.cast.media.Media) Được gọi bằng Nội dung nghe nhìn đã tải khi thành công. |
errorCallback |
function(non-null chrome.cast.Error) Được gọi do lỗi. Các lỗi có thể xảy ra là TIMEOUT, API_NOT_WITHINIZED, INVALID_METRIC, CHANNEL_ERROR, SESSION_ERROR và EXTENSION_DEFAULT. |
queueLoad
queueLoad(queueLoadRequest, successCallback, errorCallback)
Tải và tuỳ ý bắt đầu phát một hàng đợi mới gồm các mục nội dung đa phương tiện trong một ứng dụng trình nhận đang chạy.
Thông số |
|
---|---|
queueLoadRequest |
chrome.cast.media.QueueLoadRequest Yêu cầu tải một hàng đợi mới gồm các mục nội dung nghe nhìn. Giá trị không được rỗng. |
successCallback |
function(non-null chrome.cast.media.Media) Được gọi bằng Nội dung nghe nhìn đã tải khi thành công. |
errorCallback |
function(non-null chrome.cast.Error) Được gọi do lỗi. Các lỗi có thể xảy ra là TIMEOUT, API_NOT_WITHINIZED, INVALID_METRIC, CHANNEL_ERROR, SESSION_ERROR và EXTENSION_DEFAULT. |
- Không được dùng nữa
- Sử dụng cast.framework.CastSession#loadMedia và cung cấp chrome.cast.media.LoadRequest#queueData liên quan.
removeMediaListener
removeMediaListener(listener)
Xoá trình nghe đã được thêm trước đó bằng addMediaListener.
Thông số |
|
---|---|
trình nghe |
function(non-null chrome.cast.media.Media) Trình nghe cần xoá. |
removeMessageListener
removeMessageListener(namespace, listener)
Xoá trình nghe đã thêm trước đó cho các thông báo.
Thông số |
|
---|---|
vùng chứa tên |
string Không gian tên được nghe, ví dụ: "urn:x-cast:com.example.namespace". |
trình nghe |
hàm(chuỗi, chuỗi) Trình nghe cần xoá. |
removeUpdateListener
removeUpdateListener(listener)
Xoá trình nghe đã thêm trước đó cho Phiên này.
Thông số |
|
---|---|
trình nghe |
function(boolean) Trình nghe cần xoá. |
sendMessage
sendMessage(namespace, message, successCallback, errorCallback)
Gửi thông báo đến ứng dụng nhận trên không gian tên đã chỉ định. Lệnh gọi lại thành công sẽ được gọi khi thông báo đã được gửi đến kênh nhắn tin. Việc phân phối đến ứng dụng của trình nhận là cách hiệu quả nhất và không được đảm bảo.
Thông số |
|
---|---|
vùng chứa tên |
string Không gian tên sẽ gửi thông báo, ví dụ: 'urn:x-cast:com.example.namespace'. |
tin nhắn |
(non-null Object or string) |
successCallback |
hàm() Được gọi khi tin nhắn được gửi. |
errorCallback |
function(non-null chrome.cast.Error) Được gọi do lỗi. Các lỗi có thể xảy ra là TIMEOUT, API_NOT_WITHINIZED, INVALID_METRIC, CHANNEL_ERROR, SESSION_ERROR và EXTENSION_DEFAULT. |
setReceiverMuted
setReceiverMuted(muted, successCallback, errorCallback)
Đặt âm lượng của bộ thu.
Thông số |
|
---|---|
đã tắt tiếng |
boolean Trạng thái ẩn mới. |
successCallback |
hàm() |
errorCallback |
function(non-null chrome.cast.Error) Các lỗi có thể xảy ra là TIMEOUT, API_NOT_WITHINIZED, INVALID_METRIC, CHANNEL_ERROR, SESSION_ERROR và EXTENSION_DEFAULT. |
setReceiverVolumeLevel
setReceiverVolumeLevel(newLevel, successCallback, errorCallback)
Đặt âm lượng của bộ thu.
Thông số |
|
---|---|
newLevel |
number Mức âm lượng mới từ 0,0 đến 1,0. |
successCallback |
hàm() |
errorCallback |
function(non-null chrome.cast.Error) Các lỗi có thể xảy ra là TIMEOUT, API_NOT_WITHINIZED, INVALID_METRIC, CHANNEL_ERROR, SESSION_ERROR và EXTENSION_DEFAULT. |
điểm dừng
Stop(SuccessCallback, errorCallback)
Dừng ứng dụng nhận đang chạy liên kết với phiên.
Thông số |
|
---|---|
successCallback |
hàm() |
errorCallback |
function(non-null chrome.cast.Error) Các lỗi có thể xảy ra là TIMEOUT, API_NOT_WITHINIZED, CHANNEL_ERROR, SESSION_ERROR và EXTENSION_DEFAULT. |