คลาส GCKUIMediaController

เริ่มต้นอินสแตนซ์

เชื่อมโยง UILabel กับคีย์ข้อมูลเมตา

มุมมองจะแสดงค่าปัจจุบันของช่องข้อมูลเมตาที่เกี่ยวข้อง

โปรดดู GCKMediaMetadata สำหรับรายการคีย์ข้อมูลเมตาที่กำหนดไว้ล่วงหน้า

Parameters

label	The UILabel that will display the value.
key	The metadata key.

เชื่อมโยง UILabel กับคีย์ข้อมูลเมตา

มุมมองจะแสดงค่าปัจจุบันของช่องข้อมูลเมตาที่เกี่ยวข้อง

โปรดดู GCKMediaMetadata สำหรับรายการคีย์ข้อมูลเมตาที่กำหนดไว้ล่วงหน้า

Parameters

label	The UILabel that will display the value.
key	The metadata key.
formatter	A block that will produce the desired string representation of the value.

เชื่อมโยง UITextView กับคีย์ข้อมูลเมตา

มุมมองจะแสดงค่าปัจจุบันของช่องข้อมูลเมตาที่เกี่ยวข้อง

โปรดดู GCKMediaMetadata สำหรับรายการคีย์ข้อมูลเมตาที่กำหนดไว้ล่วงหน้า

Parameters

textView	The UITextView that will display the value.
key	The metadata key.

เชื่อมโยง UITextView กับคีย์ข้อมูลเมตา

มุมมองจะแสดงค่าปัจจุบันของช่องข้อมูลเมตาที่เกี่ยวข้อง

โปรดดู GCKMediaMetadata สำหรับรายการคีย์ข้อมูลเมตาที่กำหนดไว้ล่วงหน้า

Parameters

textView	The UITextView that will display the value.
key	The metadata key.
formatter	A block that will produce the desired string representation of the value.

เชื่อมโยง UIImageView กับอินสแตนซ์ GCKUIImageHints

ระบบจะใช้ GCKUIImagePicker ที่ติดตั้งอยู่ในปัจจุบันเพื่อเลือกรูปภาพจากข้อมูลเมตาสําหรับมุมมอง

Parameters

imageView	The UIImageView that will display the selected image.
imageHints	The image hints.

เชื่อมโยง UIControl เพื่อกรอกลับการเล่นรายการปัจจุบันด้วยค่าที่ส่งเป็นวินาที

มุมมองจะอัปเดตตามสถานะของ GCKCastSession, สถานะการเล่นจากระยะไกล และสถานะของสตรีมแบบสดหรือไม่ ยังเพิ่มเป้าหมายลงใน UIControl เพื่อบันทึกเหตุการณ์ UIControlEventTouchUpInside ด้วย อย่าเพิ่มเป้าหมายประเภทนี้ใน UIControl หากต้องการบันทึกเหตุการณ์ ให้ใช้เมธอด GCKUIMediaControllerDelegate แทน

Parameters

control	The UI element that the user interacts with. Typically this would be an instance of UIButton.
rewindSeconds	The number of seconds to rewind the media.

เชื่อมโยง UIControl เพื่อส่งต่อการเล่นของรายการปัจจุบันด้วยค่าที่ส่งเป็นวินาที

มุมมองจะอัปเดตตามสถานะของ GCKCastSession, สถานะการเล่นจากระยะไกล และสถานะของสตรีมแบบสดหรือไม่ ยังเพิ่มเป้าหมายลงใน UIControl เพื่อบันทึกเหตุการณ์ UIControlEventTouchUpInside ด้วย อย่าเพิ่มเป้าหมายประเภทนี้ใน UIControl หากต้องการบันทึกเหตุการณ์ ให้ใช้เมธอด GCKUIMediaControllerDelegate แทน

Parameters

control	The UI element that the user interacts with. Typically this would be an instance of UIButton.
forwardSeconds	The number of seconds to skip the media.

ยกเลิกการเชื่อมโยงข้อมูลพร็อพเพอร์ตี้ที่ระบุ

Parameters

view	The view to unbind.

ยกเลิกการเชื่อมโยงมุมมองที่เชื่อมโยงทั้งหมด

เปลี่ยนโหมดการทำซ้ำของคิวเป็นโหมดถัดไปในรอบนี้

GCKMediaRepeatModeOff → GCKMediaRepeatModeAll → GCKMediaRepeatModeSingle → GCKMediaRepeatModeAllAndShuffle

การคืนสินค้า

โหมดการทำซ้ำใหม่

วิธีการอำนวยความสะดวกในการแสดง UI การเลือกแทร็กสื่อ

ส่งและตรวจสอบคำขอโฆษณาการข้าม

Since

4.3

ผู้รับมอบสิทธิ์เพื่อรับการแจ้งเตือนจาก GCKUIMediaController

เซสชันที่เชื่อมโยงกับตัวควบคุมนี้

มีสื่อที่โหลด (หรือกำลังโหลด) อยู่ในตัวรับหรือไม่

หากไม่มีเซสชันการแคสต์ทำงานอยู่ การดำเนินการนี้จะเป็น NO

มีรายการปัจจุบันอยู่ในคิวหรือไม่

มีการโหลดรายการไว้ล่วงหน้าในคิวหรือไม่

สถานะโปรแกรมเล่นสื่อที่ทราบล่าสุด

หากไม่มีเซสชันการแคสต์ทำงานอยู่ ระบบจะแสดงสถานะของโปรแกรมเล่นก่อนเซสชันสุดท้ายจะสิ้นสุดลง หากไม่มีเซสชันก่อนหน้า ค่านี้จะเป็น GCKMediaPlayerStateUnknown

ตำแหน่งสตรีมสื่อที่ทราบล่าสุด

หากไม่มีเซสชันการแคสต์ทำงานอยู่ ตำแหน่งนี้จะเป็นตำแหน่งสตรีมของสื่อก่อนที่เซสชันสุดท้ายจะสิ้นสุดลง หากไม่มีเซสชันก่อนหน้า ค่านี้จะเป็น kGCKInvalidTimeInterval

ปุ่ม "เล่น"

เมื่อแตะปุ่ม การเล่นสื่อที่โหลดไว้ตอนนี้จะเริ่มเล่นหรือเล่นต่อในอุปกรณ์รับสัญญาณ ปุ่มนี้จะปิดใช้หากกำลังเล่นอยู่ หรือกำลังโหลดสื่อไม่ได้อยู่ หรือไม่มีเซสชันการแคสต์ที่ใช้งานอยู่ในขณะนี้

ปุ่ม "หยุดชั่วคราว"

เมื่อแตะปุ่ม การเล่นสื่อที่โหลดอยู่จะหยุดชั่วคราวบนอุปกรณ์รับ ปุ่มจะถูกปิดใช้งานหากสื่อที่โหลดอยู่ไม่รองรับการหยุดเล่นชั่วคราว หรือในกรณีที่ไม่ได้กำลังเล่นอยู่ หรือในกรณีที่ไม่ได้โหลดสื่อไว้ หรือไม่มีเซสชันการแคสต์ที่ใช้งานอยู่ในขณะนั้น

ปุ่มเปิด/ปิด "เล่น/หยุดชั่วคราว"

ผู้โทรควรกำหนดไอคอนที่เหมาะสมสำหรับสถานะปุ่ม GCKUIButtonStatePlay, GCKUIButtonStatePlayLive และ GCKUIButtonStatePause ของปุ่ม ซึ่งได้แก่ ไอคอน "หยุดชั่วคราว" สำหรับสถานะการเล่น ไอคอน "หยุด" สำหรับสถานะเล่นสด และไอคอน "เล่น" สำหรับสถานะการหยุดชั่วคราว สถานะของปุ่มจะอัปเดตโดยอัตโนมัติเพื่อแสดงสถานะการเล่นปัจจุบันบนตัวรับ เมื่อแตะปุ่ม การเล่นสื่อที่โหลดอยู่จะหยุดชั่วคราวหรือเล่นต่อบนตัวรับ ปุ่มจะถูกปิดใช้งานหากสื่อที่โหลดอยู่ไม่รองรับการหยุดชั่วคราว หรือหากการเล่นไม่ได้ดำเนินอยู่หรือหยุดชั่วคราวอยู่ หรือในกรณีที่ไม่ได้โหลดสื่อไว้ หรือไม่มีเซสชันการแคสต์ที่ใช้งานอยู่ในขณะนั้น

ตัวควบคุมปุ่มสลับ "เล่น/หยุดชั่วคราว"

ใช้เป็นตัวช่วยสำหรับ UI การสลับเล่น/หยุดชั่วคราวที่กำหนดเองจากแอปพลิเคชัน ดูรายละเอียดได้ที่ GCKUIPlayPauseToggleController

Since

3.4

ปุ่ม "หยุด"

เมื่อแตะปุ่ม การเล่นสื่อที่โหลดอยู่จะหยุดบนตัวรับ ระบบจะปิดใช้ปุ่มหากไม่มีการโหลดสื่อไว้ในขณะนั้น หรือไม่มีเซสชันการแคสต์ที่ใช้งานอยู่ในขณะนี้

ปุ่มสำหรับกรอไปข้างหน้า 30 วินาทีในรายการสื่อที่กำลังเล่นอยู่

ระบบจะปิดใช้ปุ่มหากไม่มีการโหลดสื่อไว้ในขณะนั้น หรือไม่มีเซสชันการแคสต์ที่ใช้งานอยู่ในขณะนี้

ปุ่มสำหรับกรอวิดีโอไปข้างหน้า 30 วินาทีในรายการสื่อที่กำลังเล่นอยู่

ระบบจะปิดใช้ปุ่มหากไม่มีการโหลดสื่อไว้ในขณะนั้น หรือไม่มีเซสชันการแคสต์ที่ใช้งานอยู่ในขณะนี้

ปุ่มสำหรับหยุดเล่นคิวชั่วคราวเมื่อรายการปัจจุบันเล่นเสร็จแล้ว

ปุ่ม "ถัดไป"

เมื่อแตะปุ่ม การเล่นจะย้ายไปยังรายการสื่อถัดไปในคิว ปุ่มจะปิดลงหากระบบไม่รองรับการดำเนินการนี้ หรือกำลังโหลดสื่อไม่ได้ หรือไม่มีเซสชันการแคสต์ที่ใช้งานอยู่ในขณะนี้

ปุ่ม "ก่อนหน้า"

เมื่อแตะปุ่ม การเล่นจะย้ายไปยังรายการสื่อก่อนหน้าในคิว ปุ่มจะปิดลงหากระบบไม่รองรับการดำเนินการนี้ หรือกำลังโหลดสื่อไม่ได้ หรือไม่มีเซสชันการแคสต์ที่ใช้งานอยู่ในขณะนี้

ปุ่มสำหรับวนโหมดการรอซ้ำของคิวที่มีอยู่

(โปรดดู GCKMediaRepeatMode) ผู้โทรควรตั้งค่าไอคอนที่เหมาะสมสำหรับสถานะปุ่ม GCKUIButtonStateRepeatOff, GCKUIButtonStateRepeatSingle, GCKUIButtonStateRepeatAll และ GCKUIButtonStateShuffle ของปุ่ม สถานะของปุ่มจะอัปเดตโดยอัตโนมัติเพื่อแสดงโหมดการทำซ้ำคิวปัจจุบันบนตัวรับ การแตะที่ปุ่มจะวนรอบไปยังโหมดเล่นซ้ำถัดไปตามลำดับ

GCKMediaRepeatModeOff → GCKMediaRepeatModeAll → GCKMediaRepeatModeSingle → GCKMediaRepeatModeAllAndShuffle

ระบบจะปิดใช้ปุ่มหากไม่มีเซสชันการแคสต์ที่ใช้งานอยู่ในขณะนี้

แถบเลื่อนสำหรับแสดงและเปลี่ยนตำแหน่งสตรีมปัจจุบัน

เมื่อผู้ใช้เปลี่ยนค่าของแถบเลื่อน ระบบจะอัปเดตตำแหน่งสตรีมของสื่อที่โหลดในปัจจุบันบนอุปกรณ์รับ ขณะที่กำลังเล่นสื่อบนตัวรับสัญญาณ ค่าของแถบเลื่อนจะได้รับการอัปเดตแบบเรียลไทม์เพื่อแสดงตำแหน่งสตรีมปัจจุบัน แถบเลื่อนจะถูกปิดใช้หากสื่อที่โหลดในปัจจุบันไม่รองรับการกรอวิดีโอ หรือหากไม่มีสื่อที่โหลดอยู่ หรือไม่มีเซสชันการแคสต์ที่ใช้งานอยู่ในขณะนี้

มุมมองสำหรับแสดงความคืบหน้าของสตรีมปัจจุบัน

ในขณะที่กำลังเล่นสื่อบนเครื่องรับ ค่าของมุมมองจะได้รับการอัปเดตแบบเรียลไทม์เพื่อแสดงตำแหน่งสตรีมปัจจุบัน ระบบจะปิดใช้มุมมองหากสื่อที่โหลดอยู่เป็นสตรีมแบบสด หรือไม่มีสื่อที่โหลดไว้ในขณะนั้น หรือไม่มีเซสชันการแคสต์ที่ใช้งานอยู่ในขณะนี้

ป้ายกำกับสำหรับแสดงตำแหน่งปัจจุบันของสตรีมเป็นนาทีและวินาที

หากขณะนี้ไม่มีสื่อที่โหลดหรือไม่มีเซสชันการแคสต์ที่ใช้งานอยู่ ป้ายกำกับจะแสดงรูปแบบที่แปลแล้วเป็น "--:--"

ป้ายกำกับสำหรับแสดงระยะเวลาสตรีมปัจจุบันเป็นนาทีและวินาที

หากสื่อที่โหลดในปัจจุบันไม่มีระยะเวลา (เช่น หากเป็นสตรีมแบบสด) หรือไม่มีสื่อที่โหลดไว้ในขณะนั้น หรือไม่มีเซสชันการแคสต์ที่ใช้งานอยู่ในขณะนี้ ป้ายกำกับจะแสดงรูปแบบ "--:--" ที่แปลแล้ว

ป้ายกำกับสำหรับแสดงเวลาสตรีมที่เหลืออยู่ (ระยะเวลาลบตำแหน่ง) หน่วยเป็นนาทีและวินาที

หากสื่อที่โหลดในปัจจุบันไม่มีระยะเวลา (เช่น หากเป็นสตรีมแบบสด) หรือไม่มีสื่อที่โหลดไว้ในขณะนั้น หรือไม่มีเซสชันการแคสต์ที่ใช้งานอยู่ในขณะนี้ ป้ายกำกับจะแสดงรูปแบบ "--:--" ที่แปลแล้ว

ตัวควบคุม Postdition

ใช้เป็นสแตนด์อินสำหรับตำแหน่งสตรีมที่กำหนดเองและ/หรือการค้นหา UI ดูรายละเอียดได้ที่ GCKUIStreamPositionController

Since

3.4

ตัวควบคุมอัตราการเล่นสตรีม

ดูรายละเอียดได้ที่ GCKUIPlaybackRateController

Since

4.0

กำหนดว่าเวลาสตรีมที่เหลือจะแสดงเป็นค่าลบหรือไม่ เช่น "-1:23:45"

ระบบจะตั้งค่าพร็อพเพอร์ตี้นี้เป็น YES โดยค่าเริ่มต้น

ต้องการให้ซ่อนการควบคุมตำแหน่งสตรีม (รวมถึงแถบเลื่อนตำแหน่งสตรีม ป้ายกำกับตำแหน่งสตรีม ป้ายกำกับระยะเวลาของสตรีม และมุมมองความคืบหน้าของสตรีม) สำหรับเนื้อหาสดหรือไม่

ค่าเริ่มต้นคือ NO

Since

4.0

ปุ่มสำหรับเลือกแทร็กเสียงและ/หรือคำบรรยาย

เมื่อแตะปุ่ม UI การเลือกแทร็กสื่อจะแสดงให้ผู้ใช้เห็น ปุ่มจะถูกปิดใช้งานหากสื่อที่โหลดไว้ไม่มีแทร็กสื่อที่เลือกได้ หรือไม่มีสื่อที่โหลดไว้ในขณะนั้น หรือไม่มีเซสชันการแคสต์ที่ใช้งานอยู่ในขณะนี้

ป้ายกำกับสำหรับแสดงคำบรรยายสำหรับสื่อที่โหลดไว้ในขณะนั้น

หากไม่มีการตั้งค่าช่องคำบรรยายอย่างชัดเจนในข้อมูลเมตา ค่ายเพลงจะแสดงช่องข้อมูลเมตาที่เหมาะสมที่สุดตามประเภทของสื่อ เช่น ชื่อสตูดิโอของภาพยนตร์ หรือชื่อศิลปินในแทร็กเพลง

มุมมองสัญญาณบอกสถานะกิจกรรมสำหรับระบุว่าสื่ออยู่ในสถานะการโหลด

ป้ายกำกับสำหรับแสดงระยะเวลาที่เหลือจนกระทั่งสามารถข้ามโฆษณาได้

Since

4.3

ปุ่มสำหรับข้ามโฆษณาปัจจุบัน

Since

4.3