Giản đồ đặc điểm MediaState của nhà thông minh

action.devices.traits.MediaState – Đặc điểm này được dùng cho các thiết bị có thể báo cáo trạng thái nội dung nghe nhìn.

Trợ lý sử dụng trait MediaState cho những mục đích sau:

  • Để biết nội dung đang phát trên mỗi thiết bị, liệu Trợ lý có bắt đầu phát hay không. Thông tin này giúp Trợ lý hiểu rõ hơn ý định của người dùng. Ví dụ: người dùng sẽ nói "Pause the Tonight Show" (Tạm dừng chương trình Tonight Show) khi ý định thực sự của họ là "Pause the device currently playing the Tonight Show" (Tạm dừng thiết bị đang phát chương trình Tonight Show).
  • Để có thể di chuyển giữa các trình phát nội dung nghe nhìn – nếu Trợ lý biết nội dung đang phát và vị trí phát hiện tại, thì Trợ lý có thể chuyển nội dung phát đó sang một thiết bị khác khi người dùng di chuyển giữa các phòng hoặc lưu nội dung phát để xem sau trên một thiết bị tuỳ ý.

Bạn có thể chỉ định cấp và khía cạnh của trạng thái nội dung nghe nhìn mà giải pháp của bạn cung cấp bằng cách định cấu hình các thuộc tính trong đặc điểm này. Đặc điểm này thường được dùng cùng với các đặc điểm TransportControl

Thuộc tính thiết bị

Các thiết bị có đặc điểm này có thể báo cáo các thuộc tính sau đây trong quá trình thao tác SYNC. Để tìm hiểu thêm về cách xử lý ý định SYNC, hãy xem phần Thực hiện ý định.

Thuộc tính Loại Mô tả
supportActivityState Boolean

(Mặc định: false)

Cho biết liệu thiết bị có thể báo cáo trạng thái hoạt động hay không.

supportPlaybackState Boolean

(Mặc định: false)

Cho biết liệu thiết bị có thể báo cáo trạng thái phát hiện tại hay không.

Ví dụ

Thiết bị đa phương tiện báo cáo cả hoạt động và trạng thái phát để phản hồi SYNC

{
  "supportActivityState": true,
  "supportPlaybackState": true
}

Trạng thái thiết bị

Các thực thể có đặc điểm này có thể báo cáo các trạng thái sau đây trong quá trình thực hiện thao tác QUERY. Để tìm hiểu thêm về cách xử lý ý định QUERY, hãy xem phần Thực hiện ý định.

Tiểu bang Loại Mô tả
activityState String

Cho biết liệu thiết bị có đang hoạt động và người dùng có đang tích cực tương tác với thiết bị đó hay không.

Các giá trị được hỗ trợ:

INACTIVE
STANDBY
ACTIVE
playbackState String

Cho biết trạng thái hiện tại khi phát nội dung nghe nhìn.

Các giá trị được hỗ trợ:

PAUSED
PLAYING
FAST_FORWARDING
REWINDING
BUFFERING
STOPPED

Ví dụ

Thiết bị đa phương tiện báo cáo cả hoạt động và trạng thái phát

{
  "activityState": "ACTIVE",
  "playbackState": "PAUSED"
}

LỆNH thiết bị

Không có.

LỖI thiết bị

Xem danh sách đầy đủ lỗi và ngoại lệ.