เพิ่มฟีเจอร์หลักลงในตัวรับสัญญาณเว็บที่กำหนดเอง

หน้าเว็บนี้มีข้อมูลโค้ดและคำอธิบายฟีเจอร์ที่พร้อมใช้งานสำหรับ แอป Web Receiver ที่กำหนดเอง

  1. องค์ประกอบ cast-media-player ที่แสดง UI โปรแกรมเล่นในตัว ซึ่งมาพร้อมกับ Web Receiver
  2. การจัดรูปแบบที่เหมือน CSS ที่กำหนดเองสำหรับองค์ประกอบ cast-media-player เพื่อจัดรูปแบบให้หลากหลาย องค์ประกอบ UI เช่น background-image, splash-image และ font-family
  3. องค์ประกอบของสคริปต์สำหรับโหลดเฟรมเวิร์กตัวรับเว็บ
  4. โค้ด JavaScript เพื่อสกัดกั้นข้อความและจัดการกับเหตุการณ์
  5. จัดคิวเล่นอัตโนมัติ
  6. ตัวเลือกเพื่อกำหนดค่าการเล่น
  7. ตัวเลือกในการตั้งค่าบริบทของตัวรับเว็บ
  8. ตัวเลือกในการตั้งค่าคำสั่งที่แอป Web Receiver รองรับ
  9. การเรียกใช้ JavaScript เพื่อเริ่มแอปพลิเคชัน Web Receiver

การกำหนดค่าและตัวเลือกแอปพลิเคชัน

กำหนดค่าแอปพลิเคชัน

CastReceiverContext เป็นคลาสนอกสุดให้นักพัฒนาซอฟต์แวร์เห็น และจัดการการโหลด ไลบรารีที่สำคัญและจัดการการเริ่มต้น SDK ของ Web Receiver SDK มี API ที่อนุญาตให้นักพัฒนาแอปพลิเคชันกำหนดค่า SDK ผ่าน CastReceiverOptions การกำหนดค่าเหล่านี้จะได้รับการประเมิน 1 ครั้งในการเปิดใช้งานแอปพลิเคชันแต่ละครั้งและจะส่งไปยัง SDK เมื่อตั้งค่าพารามิเตอร์ที่ไม่บังคับในการเรียก start

ตัวอย่างด้านล่างแสดงวิธีลบล้างลักษณะการทำงานเริ่มต้นเพื่อตรวจหาว่า การเชื่อมต่อของผู้ส่งยังคงเชื่อมต่ออยู่ เมื่อเว็บรีซีฟเวอร์ไม่ได้ สามารถสื่อสารกับผู้ส่งรายหนึ่งได้ maxInactivity วินาที ระบบจะส่งออกเหตุการณ์ SENDER_DISCONNECTED การกำหนดค่าด้านล่าง จะลบล้างการหมดเวลานี้ ซึ่งจะมีประโยชน์ในการแก้ไขข้อบกพร่อง เนื่องจากเป็นการป้องกัน แอป Web Receiver ไม่ให้ปิดเซสชันโปรแกรมแก้ไขข้อบกพร่องระยะไกลของ Chrome เป็น 0 ผู้ส่งที่เชื่อมต่อในสถานะ IDLE

const context = cast.framework.CastReceiverContext.getInstance();
const options = new cast.framework.CastReceiverOptions();
options.maxInactivity = 3600; // Development only
context.start(options);

กำหนดค่าโปรแกรมเล่น

เมื่อโหลดเนื้อหา Web Receiver SDK มอบวิธีในการกำหนดค่าการเล่น ตัวแปร เช่น DRM ข้อมูล ลองกำหนดค่าอีกครั้ง และเครื่องจัดการคำขอโดยใช้ cast.framework.PlaybackConfig ข้อมูลนี้จัดการโดย PlayerManager และจะได้รับการประเมินในเวลาที่สร้างผู้เล่น สร้างผู้เล่นแล้ว ทุกครั้งที่มีการส่งโหลดใหม่ไปยัง SDK ของตัวรับเว็บ การปรับเปลี่ยนใน PlaybackConfigหลังจากสร้างโปรแกรมเล่นแล้วจะได้รับการประเมินใน การโหลดเนื้อหา SDK มีวิธีต่อไปนี้สำหรับการแก้ไข PlaybackConfig

  • CastReceiverOptions.playbackConfig เพื่อลบล้างตัวเลือกการกำหนดค่าเริ่มต้นเมื่อเริ่มต้น CastReceiverContext
  • PlayerManager.getPlaybackConfig() เพื่อรับการกำหนดค่าปัจจุบัน
  • PlayerManager.setPlaybackConfig() เพื่อลบล้างการกำหนดค่าปัจจุบัน การตั้งค่านี้จะมีผลกับ การโหลดครั้งต่อๆ ไปหรือจนกว่าจะมีการลบล้างอีกครั้ง
  • PlayerManager.setMediaPlaybackInfoHandler() เพื่อใช้การกำหนดค่าเพิ่มเติมสำหรับรายการสื่อที่โหลดอยู่เท่านั้น ด้านบนของการกำหนดค่าปัจจุบัน เครื่องจัดการจะถูกเรียกก่อนโปรแกรมเล่น งานสร้างสรรค์ การเปลี่ยนแปลงที่ทำที่นี่ไม่ใช่แบบถาวรและจะไม่รวมอยู่ในการค้นหา ไปยัง getPlaybackConfig() เมื่อรายการสื่อถัดไปโหลดขึ้นมา เครื่องจัดการนี้ จะถูกเรียกอีกครั้ง

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

const playbackConfig = new cast.framework.PlaybackConfig();
playbackConfig.manifestRequestHandler = requestInfo => {
  requestInfo.withCredentials = true;
};
context.start({playbackConfig: playbackConfig});

ตัวอย่างด้านล่างแสดงวิธีลบล้าง PlaybackConfig โดยใช้ Getter และ Setter ที่มีให้ใน PlayerManager การตั้งค่าจะกำหนดให้โปรแกรมเล่น เล่นเนื้อหาต่อหลังจากโหลด 1 ส่วนแล้ว

const playerManager =
    cast.framework.CastReceiverContext.getInstance().getPlayerManager();
const playbackConfig = (Object.assign(
            new cast.framework.PlaybackConfig(), playerManager.getPlaybackConfig()));
playbackConfig.autoResumeNumberOfSegments = 1;
playerManager.setPlaybackConfig(playbackConfig);

ตัวอย่างด้านล่างแสดงวิธีลบล้าง PlaybackConfig สำหรับการโหลดที่เฉพาะเจาะจง โดยใช้เครื่องจัดการข้อมูลการเล่นสื่อ ตัวแฮนเดิลเรียกใช้แอปพลิเคชัน ใช้เมธอด getLicenseUrlForMedia ในการรับ licenseUrl จาก contentIdของรายการปัจจุบัน

playerManager.setMediaPlaybackInfoHandler((loadRequestData, playbackConfig) => {
  const mediaInformation = loadRequestData.media;
  playbackConfig.licenseUrl = getLicenseUrlForMedia(mediaInformation.contentId);

  return playbackConfig;
});

Listener เหตุการณ์

Web Receiver SDK ทำให้แอป Web Receiver ของคุณจัดการเหตุการณ์ของโปรแกรมเล่นได้ Listener เหตุการณ์ใช้เวลา cast.framework.events.EventType พารามิเตอร์ (หรืออาร์เรย์ของพารามิเตอร์เหล่านี้) ที่ระบุเหตุการณ์ จะทริกเกอร์ Listener ได้ อาร์เรย์ที่กำหนดค่าไว้ล่วงหน้าของ ดู cast.framework.events.EventType ที่เป็นประโยชน์สำหรับการแก้ไขข้อบกพร่องได้ใน cast.framework.events.category พารามิเตอร์เหตุการณ์ให้ข้อมูลเพิ่มเติมเกี่ยวกับเหตุการณ์

เช่น ถ้าต้องการทราบว่าเมื่อใด mediaStatus มีการเผยแพร่การเปลี่ยนแปลง คุณสามารถใช้ตรรกะต่อไปนี้ในการจัดการ กิจกรรม:

const playerManager =
    cast.framework.CastReceiverContext.getInstance().getPlayerManager();
playerManager.addEventListener(
    cast.framework.events.EventType.MEDIA_STATUS, (event) => {
      // Write your own event handling code, for example
      // using the event.mediaStatus value
});

การดักฟังข้อความ

SDK ของตัวรับเว็บช่วยให้แอปตัวรับเว็บสามารถสกัดกั้นข้อความและ เรียกใช้โค้ดที่กำหนดเองกับข้อความเหล่านั้น เครื่องมือดักจับข้อความจะรับ cast.framework.messages.MessageType ที่ระบุประเภทข้อความที่ควรถูกดักจับ

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

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

const context = cast.framework.CastReceiverContext.getInstance();
const playerManager = context.getPlayerManager();

playerManager.setMessageInterceptor(
    cast.framework.messages.MessageType.LOAD, loadRequestData => {
      const error = new cast.framework.messages.ErrorData(
                      cast.framework.messages.ErrorType.LOAD_FAILED);
      if (!loadRequestData.media) {
        error.reason = cast.framework.messages.ErrorReason.INVALID_PARAM;
        return error;
      }

      if (!loadRequestData.media.entity) {
        return loadRequestData;
      }

      return thirdparty.fetchAssetAndAuth(loadRequestData.media.entity,
                                          loadRequestData.credentials)
        .then(asset => {
          if (!asset) {
            throw cast.framework.messages.ErrorReason.INVALID_REQUEST;
          }

          loadRequestData.media.contentUrl = asset.url;
          loadRequestData.media.metadata = asset.metadata;
          loadRequestData.media.tracks = asset.tracks;
          return loadRequestData;
        }).catch(reason => {
          error.reason = reason; // cast.framework.messages.ErrorReason
          return error;
        });
    });

context.start();

การจัดการข้อผิดพลาด

เมื่อเกิดข้อผิดพลาดในตัวดักจับข้อความ แอป Web Receiver ของคุณควรจะแสดงผล แอปที่เหมาะสม cast.framework.messages.ErrorType และ cast.framework.messages.ErrorReason

playerManager.setMessageInterceptor(
    cast.framework.messages.MessageType.LOAD, loadRequestData => {
      const error = new cast.framework.messages.ErrorData(
                      cast.framework.messages.ErrorType.LOAD_CANCELLED);
      if (!loadRequestData.media) {
        error.reason = cast.framework.messages.ErrorReason.INVALID_PARAM;
        return error;
      }

      ...

      return fetchAssetAndAuth(loadRequestData.media.entity,
                               loadRequestData.credentials)
        .then(asset => {
          ...
          return loadRequestData;
        }).catch(reason => {
          error.reason = reason; // cast.framework.messages.ErrorReason
          return error;
        });
    });

การดักจับข้อความเทียบกับ Listener เหตุการณ์

ความแตกต่างที่สำคัญบางประการระหว่างการดักจับข้อความและ Listener เหตุการณ์มีดังนี้ ดังต่อไปนี้:

  • Listener เหตุการณ์ไม่อนุญาตให้คุณแก้ไขข้อมูลคำขอ
  • Listener เหตุการณ์จะใช้เพื่อทริกเกอร์การวิเคราะห์หรือฟังก์ชันที่กำหนดเองได้ดีที่สุด
playerManager.addEventListener(cast.framework.events.category.CORE,
    event => {
        console.log(event);
    });
  • การดักจับข้อความช่วยให้คุณฟังข้อความ ดักจับข้อความ และ แก้ไขข้อมูลคำขอเอง
  • การดักจับข้อความเป็นวิธีที่เหมาะสมที่สุดในการจัดการกับตรรกะที่กำหนดเองเกี่ยวกับ คำขอข้อมูล

กำลังโหลดสื่อ

MediaInformation มีคุณสมบัติหลากหลายสำหรับการโหลดสื่อใน cast.framework.messages.MessageType.LOAD ข้อความรวมถึง entity contentUrl และ contentId

  • entity เป็นคุณสมบัติที่แนะนำในการใช้งานของคุณสำหรับทั้งผู้ส่งและ แอปตัวรับสัญญาณ พร็อพเพอร์ตี้เป็น URL ของ Deep Link ที่เป็นได้ทั้งเพลย์ลิสต์ หรือเนื้อหาสื่อ แอปพลิเคชันคุณควรแยกวิเคราะห์ URL นี้และ ป้อนข้อมูลอย่างน้อย 1 ช่องจากอีก 2 ช่อง
  • contentUrl สอดคล้องกับ URL ที่เล่นได้ซึ่งโปรแกรมเล่นจะใช้ในการโหลดเนื้อหา เช่น URL นี้อาจชี้ไปยังไฟล์ Manifest ของ DASH
  • contentId อาจเป็น URL เนื้อหาที่เล่นได้ (คล้ายกับของ contentUrl ) หรือตัวระบุที่ไม่ซ้ำกันสำหรับเนื้อหาหรือเพลย์ลิสต์ที่โหลด หากใช้พร็อพเพอร์ตี้นี้เป็นตัวระบุ แอปพลิเคชันของคุณควรป้อนข้อมูล URL ที่เล่นได้ใน contentUrl

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

playerManager.setMessageInterceptor(
    cast.framework.messages.MessageType.LOAD, loadRequestData => {
      ...

      if (!loadRequestData.media.entity) {
        // Copy the value from contentId for legacy reasons if needed
        loadRequestData.media.entity = loadRequestData.media.contentId;
      }

      return thirdparty.fetchAssetAndAuth(loadRequestData.media.entity,
                                          loadRequestData.credentials)
        .then(asset => {
          loadRequestData.media.contentUrl = asset.url;
          ...
          return loadRequestData;
        });
    });

ความสามารถของอุปกรณ์

getDeviceCapabilities ในการจัดเตรียมข้อมูลในอุปกรณ์ Cast ที่เชื่อมต่อและวิดีโอ หรือ ต่ออุปกรณ์เสียงอยู่ เมธอด getDeviceCapabilities ให้การสนับสนุน ข้อมูลสำหรับ Google Assistant, บลูทูธ รวมถึงจอแสดงผลและเสียงที่เชื่อมต่อ อุปกรณ์

วิธีนี้จะส่งคืนออบเจ็กต์ที่ค้นหาได้โดยการส่งผ่านออบเจ็กต์รายการใดรายการหนึ่ง enum ที่ระบุเพื่อรับความสามารถของอุปกรณ์สำหรับ enum นั้น Enum คือ กำหนดไว้ใน cast.framework.system.DeviceCapabilities

ตัวอย่างนี้ตรวจสอบว่าอุปกรณ์ตัวรับสัญญาณเว็บเล่น HDR ได้หรือไม่ และ DolbyVision (DV) ด้วยคีย์ IS_HDR_SUPPORTED และ IS_DV_SUPPORTED ตามลำดับ

const context = cast.framework.CastReceiverContext.getInstance();
context.addEventListener(cast.framework.system.EventType.READY, () => {
  const deviceCapabilities = context.getDeviceCapabilities();
  if (deviceCapabilities &&
      deviceCapabilities[cast.framework.system.DeviceCapabilities.IS_HDR_SUPPORTED]) {
    // Write your own event handling code, for example
    // using the deviceCapabilities[cast.framework.system.DeviceCapabilities.IS_HDR_SUPPORTED] value
  }
  if (deviceCapabilities &&
      deviceCapabilities[cast.framework.system.DeviceCapabilities.IS_DV_SUPPORTED]) {
    // Write your own event handling code, for example
    // using the deviceCapabilities[cast.framework.system.DeviceCapabilities.IS_DV_SUPPORTED] value
  }
});
context.start();

การจัดการการโต้ตอบของผู้ใช้

ผู้ใช้สามารถโต้ตอบกับแอปพลิเคชัน Web Receiver ผ่านผู้ส่งได้ แอปพลิเคชัน (เว็บ, Android และ iOS), คำสั่งเสียงบนอุปกรณ์ที่พร้อมใช้งาน Assistant อุปกรณ์ต่างๆ การควบคุมด้วยการสัมผัสบนจออัจฉริยะ และรีโมตคอนโทรลใน Android TV อุปกรณ์ Cast SDK มี API มากมายที่ช่วยให้แอป Web Receiver สามารถ จัดการการโต้ตอบเหล่านี้ อัปเดต UI ของแอปพลิเคชัน สถานะการดำเนินการของผู้ใช้ และส่งการเปลี่ยนแปลงเพื่ออัปเดตบริการแบ็กเอนด์ทั้งหมดหรือไม่ก็ได้

คำสั่งสื่อที่รองรับ

สถานะการควบคุม UI ขับเคลื่อนโดย MediaStatus.supportedMediaCommands สำหรับตัวควบคุมแบบขยาย ตัวรับ และรีโมตคอนโทรลสำหรับผู้ส่ง iOS และ Android แอปที่ทำงานในอุปกรณ์ระบบสัมผัส และแอปตัวรับสัญญาณในอุปกรณ์ Android TV เมื่อ เปิดใช้บิตไวส์ Command ในพร็อพเพอร์ตี้แล้ว ปุ่มต่างๆ ที่เกี่ยวข้องกับการดำเนินการนั้นเปิดใช้อยู่ หากไม่ได้ตั้งค่าไว้ ระบบจะใช้ปุ่ม ปิดใช้อยู่ ค่าเหล่านี้สามารถเปลี่ยนแปลงได้ในเว็บรีซีฟเวอร์โดยทำดังนี้

  1. การใช้ PlayerManager.setSupportedMediaCommands เพื่อตั้งค่า Commands
  2. การเพิ่มคำสั่งใหม่โดยใช้ addSupportedMediaCommands
  3. การนำคำสั่งที่มีอยู่ออกโดยใช้ removeSupportedMediaCommands
playerManager.setSupportedMediaCommands(cast.framework.messages.Command.SEEK |
  cast.framework.messages.Command.PAUSE);

เมื่อผู้รับเตรียม MediaStatus ที่อัปเดตแล้ว จะมีฟิลด์ การเปลี่ยนแปลงในพร็อพเพอร์ตี้ supportedMediaCommands เมื่อสถานะคือ แล้ว แอปผู้ส่งที่เชื่อมต่อจะอัปเดตปุ่มใน UI ของตน ตามนั้น

ดูข้อมูลเพิ่มเติมเกี่ยวกับคำสั่งสื่อและอุปกรณ์ระบบสัมผัสที่รองรับได้ที่ Accessing UI controls

การจัดการสถานะการดำเนินการของผู้ใช้

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

  • ตั้งค่าMediaInformation userActionStates ตามค่ากำหนดของผู้ใช้เมื่อโหลดรายการสื่อ
  • สกัดกั้นข้อความ USER_ACTION รายการและระบุการดำเนินการที่ขอ
  • อัปเดต UserActionState ของ MediaInformation เพื่ออัปเดต UI

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

playerManager.setMessageInterceptor(
    cast.framework.messages.MessageType.LOAD, (loadRequestData) => {
      const userActionLike = new cast.framework.messages.UserActionState(
          cast.framework.messages.UserAction.LIKE);
      loadRequestData.media.userActionStates = [userActionLike];

      return loadRequestData;
    });

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

playerManager.setMessageInterceptor(cast.framework.messages.MessageType.USER_ACTION,
  (userActionRequestData) => {
    // Obtain the media information of the current content to associate the action to.
    let mediaInfo = playerManager.getMediaInformation();

    // If there is no media info return an error and ignore the request.
    if (!mediaInfo) {
        console.error('Not playing media, user action is not supported');
        return new cast.framework.messages.ErrorData(messages.ErrorType.BAD_REQUEST);
    }

    // Reach out to backend services to store user action modifications. See sample below.
    return sendUserAction(userActionRequestData, mediaInfo)

    // Upon response from the backend, update the client's UserActionState.
    .then(backendResponse => updateUserActionStates(backendResponse))

    // If any errors occurred in the backend return them to the cast receiver.
    .catch((error) => {
      console.error(error);
      return error;
    });
});

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

function sendUserAction(userActionRequestData, mediaInfo) {
  return new Promise((resolve, reject) => {
    switch (userActionRequestData.userAction) {
      // Handle user action changes supported by the backend.
      case cast.framework.messages.UserAction.LIKE:
      case cast.framework.messages.UserAction.DISLIKE:
      case cast.framework.messages.UserAction.FOLLOW:
      case cast.framework.messages.UserAction.UNFOLLOW:
      case cast.framework.messages.UserAction.FLAG:
      case cast.framework.messages.UserAction.SKIP_AD:
        let backendResponse = {userActionRequestData: userActionRequestData, mediaInfo: mediaInfo};
        setTimeout(() => {resolve(backendResponse)}, 1000);
        break;
      // Reject all other user action changes.
      default:
        reject(
          new cast.framework.messages.ErrorData(cast.framework.messages.ErrorType.INVALID_REQUEST));
    }
  });
}

ข้อมูลโค้ดต่อไปนี้ใช้ UserActionRequestData และอาจเพิ่มหรือ นำ UserActionState ออกจาก MediaInformation กำลังอัปเดต UserActionState จาก MediaInformation เปลี่ยนสถานะของปุ่มที่ เชื่อมโยงกับการทำงานที่ขอ การเปลี่ยนแปลงนี้จะแสดงในตาราง UI ตัวควบคุมการแสดงผล แอปรีโมตคอนโทรล และ UI ของ Android TV และยัง ประกาศผ่านข้อความขาออก MediaStatus เพื่ออัปเดต UI ของ ตัวควบคุมแบบขยายสำหรับผู้ส่ง iOS และ Android

function updateUserActionStates(backendResponse) {
  // Unwrap the backend response.
  let mediaInfo = backendResponse.mediaInfo;
  let userActionRequestData = backendResponse.userActionRequestData;

  // If the current item playing has changed, don't update the UserActionState for the current item.
  if (playerManager.getMediaInformation().entity !== mediaInfo.entity) {
    return;
  }

  // Check for existing userActionStates in the MediaInformation.
  // If none, initialize a new array to populate states with.
  let userActionStates = mediaInfo.userActionStates || [];

  // Locate the index of the UserActionState that will be updated in the userActionStates array.
  let index = userActionStates.findIndex((currUserActionState) => {
    return currUserActionState.userAction == userActionRequestData.userAction;
  });

  if (userActionRequestData.clear) {
    // Remove the user action state from the array if cleared.
    if (index >= 0) {
      userActionStates.splice(index, 1);
    }
    else {
      console.warn("Could not find UserActionState to remove in MediaInformation");
    }
  } else {
    // Add the UserActionState to the array if enabled.
    userActionStates.push(
      new cast.framework.messages.UserActionState(userActionRequestData.userAction));
  }

  // Update the UserActionState array and set the new MediaInformation
  mediaInfo.userActionStates = userActionStates;
  playerManager.setMediaInformation(mediaInfo, true);
  return;
}

คำสั่งเสียง

ปัจจุบัน SDK ตัวรับเว็บรองรับคำสั่งสื่อต่อไปนี้สำหรับ อุปกรณ์ที่พร้อมใช้งาน Assistant การใช้งานเริ่มต้นของคำสั่งเหล่านี้คือ พบใน cast.framework.PlayerManager

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

คำสั่งเสียงที่รองรับสำหรับสื่อ

หากต้องการป้องกันไม่ให้คำสั่งเสียงทริกเกอร์คำสั่งสื่อใน Assistant อุปกรณ์ที่คุณใช้งานอยู่ ก่อนอื่นคุณต้องตั้งค่า คำสั่งสื่อที่รองรับ ที่คุณวางแผนจะรองรับ จากนั้นคุณต้องบังคับใช้คำสั่งเหล่านั้นโดยเปิดใช้ เวลา CastReceiverOptions.enforceSupportedCommands UI ของผู้ส่ง Cast SDK และอุปกรณ์ที่เปิดใช้ระบบสัมผัสจะเปลี่ยนเป็น ให้สอดคล้องกับการกำหนดค่าเหล่านี้ หากธงไม่ได้เปิดใช้งานเสียงที่เข้ามา ที่จะดำเนินการ

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

ในตัวอย่างด้านล่าง เราได้ให้ CastReceiverOptions เมื่อเริ่มต้น CastReceiverContext เราได้เพิ่มการสนับสนุนสำหรับคำสั่ง PAUSE และ บังคับใช้โปรแกรมเล่นให้สนับสนุนเฉพาะคำสั่งนั้น ทีนี้หากคำสั่งเสียง ขอการดำเนินการอื่น เช่น SEEK คำขอจะถูกปฏิเสธ ผู้ใช้จะ แจ้งว่ายังไม่รองรับคำสั่งดังกล่าว

const context = cast.framework.CastReceiverContext.getInstance();

context.start({
  enforceSupportedCommands: true,
  supportedCommands: cast.framework.messages.Command.PAUSE
});

คุณสามารถใช้ตรรกะแยกกันสำหรับแต่ละคำสั่งที่ต้องการจำกัดได้ นำออก แฟล็ก enforceSupportedCommands และคำสั่งแต่ละรายการที่คุณต้องการ จำกัด คุณก็สามารถสกัดกั้นข้อความขาเข้าได้ เราได้สกัดกั้นคำขอ ระบุโดย SDK เพื่อให้คำสั่ง SEEK ที่ออกให้กับอุปกรณ์ที่พร้อมใช้งาน Assistant ไม่ทริกเกอร์การค้นหาในแอปพลิเคชัน Web Receiver ของคุณ

สำหรับคำสั่งสื่อที่แอปพลิเคชันของคุณไม่รองรับ ให้ส่งค่า สาเหตุของข้อผิดพลาด เช่น NOT_SUPPORTED

playerManager.setMessageInterceptor(cast.framework.messages.MessageType.SEEK,
  seekData => {
    // Block seeking if the SEEK supported media command is disabled
    if (!(playerManager.getSupportedMediaCommands() & cast.framework.messages.Command.SEEK)) {
      let e = new cast.framework.messages.ErrorData(cast.framework.messages.ErrorType
      .INVALID_REQUEST);
      e.reason = cast.framework.messages.ErrorReason.NOT_SUPPORTED;
      return e;
    }

    return seekData;
  });

เบื้องหลังจากกิจกรรมเสียง

หากแพลตฟอร์ม Cast ใช้พื้นหลังของเสียงแอปพลิเคชันเนื่องจาก Assistant เช่น ฟังคำพูดของผู้ใช้หรือพูดตอบ FocusState ข้อความ NOT_IN_FOCUS จะถูกส่งไปยังแอปพลิเคชันเว็บรีซีฟเวอร์เมื่อ กิจกรรมเริ่มขึ้น ระบบจะส่งข้อความอีกฉบับกับ IN_FOCUS เมื่อกิจกรรมสิ้นสุดลง คุณอาจต้องทำดังนี้ ทั้งนี้ขึ้นอยู่กับแอปพลิเคชันและสื่อที่เล่น หยุดสื่อชั่วคราวเมื่อ FocusState คือ NOT_IN_FOCUS ด้วยการสกัดกั้นข้อความ ประเภท FOCUS_STATE

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

playerManager.setMessageInterceptor(cast.framework.messages.MessageType.FOCUS_STATE,
  focusStateRequestData => {
    // Pause content when the app is out of focus. Resume when focus is restored.
    if (focusStateRequestData.state == cast.framework.messages.FocusState.NOT_IN_FOCUS) {
      playerManager.pause();
    } else {
      playerManager.play();
    }

    return focusStateRequestData;
  });

ภาษาของคำบรรยายแทนเสียงที่ระบุเสียง

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

ตัวอย่างเช่น isSuggestedLanguage ได้รับการตั้งค่าเป็น true สำหรับคำสั่ง "Ok Google เปิดคำบรรยาย" เนื่องจากภาษาได้รับการอนุมานโดยภาษาที่ มีการพูดคำสั่ง หากมีการร้องขอภาษาอย่างชัดเจน เช่น ใน "ตกลง" Google เปิดคำบรรยายภาษาอังกฤษหน่อย" ตั้งค่า isSuggestedLanguage เป็น false

การแคสต์ข้อมูลเมตาและการแคสต์เสียง

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

การโอนสตรีม

การรักษาสถานะเซสชันเป็นพื้นฐานของการโอนสตรีมโดย ผู้ใช้สามารถย้ายสตรีมเสียงและวิดีโอที่มีอยู่ในอุปกรณ์ต่างๆ ได้โดยใช้คำสั่งเสียง, Google Home แอปหรือจออัจฉริยะ สื่อจะหยุดเล่นบนอุปกรณ์หนึ่ง (ต้นทาง) แต่เล่นต่อในอุปกรณ์อื่น ( ปลายทาง) อุปกรณ์แคสต์ทุกเครื่องที่มีเฟิร์มแวร์เวอร์ชันล่าสุดสามารถใช้เป็นแหล่งที่มาหรือปลายทางใน การโอนสตรีม

โฟลว์เหตุการณ์สำหรับการโอนสตรีมคือ

  1. ในอุปกรณ์ต้นทาง
    1. สื่อหยุดเล่น
    2. แอปพลิเคชันเว็บรีซีฟเวอร์ได้รับคำสั่งเพื่อบันทึกสื่อปัจจุบัน
    3. แอปพลิเคชัน Web Receiver ถูกปิด
  2. บนอุปกรณ์ปลายทาง ให้ทำดังนี้
    1. โหลดแอปพลิเคชัน Web Receiver แล้ว
    2. แอปพลิเคชันเว็บรีซีฟเวอร์ได้รับคำสั่งเพื่อคืนค่าสื่อที่บันทึกไว้
    3. สื่อเล่นต่อ

องค์ประกอบของสถานะสื่อมีดังนี้

  • ตำแหน่งหรือการประทับเวลาที่เจาะจงของเพลง วิดีโอ หรือรายการสื่อ
  • อยู่ในคิวที่กว้างกว่า (เช่น เพลย์ลิสต์หรือสถานีวิทยุของศิลปิน)
  • ผู้ใช้ที่ตรวจสอบสิทธิ์แล้ว
  • สถานะการเล่น (เช่น กำลังเล่นหรือหยุดชั่วคราว)

การเปิดใช้การโอนสตรีม

วิธีใช้การโอนสตรีมสำหรับ Web Receiver

  1. อัปเดต supportedMediaCommands ด้วยคำสั่ง STREAM_TRANSFER:
    playerManager.addSupportedMediaCommands(
    cast.framework.messages.Command.STREAM_TRANSFER, true);
  2. (ไม่บังคับ) ลบล้างข้อความ SESSION_STATE และ RESUME_SESSION Interceptor ตามที่อธิบายไว้ในเซสชันการรักษาผู้ใช้ ลบล้างข้อมูลเหล่านี้เฉพาะเมื่อจําเป็นต้องใช้ข้อมูลที่กําหนดเองเท่านั้น ที่จะจัดเก็บเป็นส่วนหนึ่งของสแนปชอตเซสชัน มิเช่นนั้น ค่าเริ่มต้น การใช้สำหรับการรักษาสถานะเซสชันจะรองรับการโอนสตรีม

การรักษาสถานะเซสชัน

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

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

playerManager.setMessageInterceptor(
    cast.framework.messages.MessageType.SESSION_STATE,
    function (sessionState) {
        // Override sessionState.loadRequestData if needed.
        const newCredentials = updateCredentials_(sessionState.loadRequestData.credentials);
        sessionState.loadRequestData.credentials = newCredentials;

        // Add custom data if needed.
        sessionState.loadRequestData.customData = {
            'membership': 'PREMIUM'
        };

        return sessionState;
    });

คุณสามารถดึงข้อมูลที่กำหนดเองจาก loadRequestData.customData ในตัวดักจับข้อความ RESUME_SESSION

let cred_ = null;
let membership_ = null;

playerManager.setMessageInterceptor(
    cast.framework.messages.MessageType.RESUME_SESSION,
    function (resumeSessionRequest) {
        let sessionState = resumeSessionRequest.sessionState;

        // Modify sessionState.loadRequestData if needed.
        cred_ = sessionState.loadRequestData.credentials;

        // Retrieve custom data.
        membership_ = sessionState.loadRequestData.customData.membership;

        return resumeSessionRequest;
    });

การโหลดเนื้อหาล่วงหน้า

ตัวรับเว็บรองรับการโหลดรายการสื่อล่วงหน้าหลังจากการเล่นปัจจุบัน ในคิว

การดำเนินการโหลดล่วงหน้าจะดาวน์โหลดกลุ่มต่างๆ ของ รายการที่กำลังจะมาถึง ข้อกำหนดดังกล่าวทำใน preloadTime ในฟิลด์ ออบเจ็กต์ QueueItem (ค่าเริ่มต้นคือ 20 วินาทีหากไม่มีการระบุไว้) เวลาจะแสดงเป็นวินาที เมื่อเทียบกับส่วนท้ายของรายการที่เล่นอยู่ในปัจจุบัน เฉพาะค่าบวกเท่านั้นที่ ใช้ได้ เช่น หากค่าเป็น 10 วินาที รายการนี้จะโหลดล่วงหน้า 10 วินาทีก่อนที่รายการก่อนหน้าจะจบลง หากเวลาในการโหลดล่วงหน้าสูงขึ้น มากกว่าเวลาที่เหลืออยู่ของ CurrentItem การโหลดล่วงหน้าจะเกิดขึ้นทันที เท่าที่จะเป็นไปได้ ดังนั้นหากระบุค่าที่สูงมากของการโหลดล่วงหน้าในQueueItem จะมีค่าเท่ากับ อาจให้ผลลัพธ์ตามที่เรากำลัง เล่นรายการปัจจุบันอยู่ กำลังโหลดรายการถัดไปไว้ล่วงหน้า อย่างไรก็ตาม เราคงการตั้งค่าและตัวเลือกในการ ให้กับนักพัฒนาซอฟต์แวร์ เนื่องจากค่านี้อาจส่งผลต่อแบนด์วิดท์และประสิทธิภาพการสตรีม ของรายการที่เล่นอยู่ในขณะนั้น

โดยค่าเริ่มต้น การโหลดล่วงหน้าจะใช้ได้กับเนื้อหา HLS, DASH และ Smooth Streaming

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

ข้อความที่กำหนดเอง

การแลกเปลี่ยนข้อความเป็นวิธีการโต้ตอบที่สำคัญสำหรับแอปพลิเคชันตัวรับเว็บ

ผู้ส่งออกข้อความไปยัง Web Receiver โดยใช้ API ผู้ส่งสำหรับ แพลตฟอร์มที่ผู้ส่งใช้อยู่ (Android, iOS, เว็บ) ออบเจ็กต์เหตุการณ์ (ซึ่ง คือการแสดงข้อความ) ที่ส่งไปยัง Listener เหตุการณ์ เอลิเมนต์ข้อมูล (event.data) ที่ข้อมูลต้องใช้พร็อพเพอร์ตี้ของ ประเภทเหตุการณ์ที่เจาะจง

แอปพลิเคชัน Web Receiver อาจเลือกที่จะฟังข้อความ Namespace จากการดำเนินการดังกล่าว แอปพลิเคชันตัวรับเว็บจึงถือว่า รองรับโปรโตคอลเนมสเปซนั้น จากนั้น จะขึ้นอยู่กับผู้ส่งที่เชื่อมต่อ สื่อสารในเนมสเปซนั้นเพื่อใช้โปรโตคอลที่เหมาะสม

เนมสเปซทั้งหมดกำหนดโดยสตริงและต้องขึ้นต้นด้วย "urn:x-cast:" ตามด้วยสตริงใดๆ ตัวอย่างเช่น "urn:x-cast:com.example.cast.mynamespace"

นี่คือข้อมูลโค้ดสำหรับตัวรับเว็บเพื่อฟังข้อความที่กำหนดเองจาก ผู้ส่งที่เชื่อมต่อ:

const context = cast.framework.CastReceiverContext.getInstance();

const CUSTOM_CHANNEL = 'urn:x-cast:com.example.cast.mynamespace';
context.addCustomMessageListener(CUSTOM_CHANNEL, function(customEvent) {
  // handle customEvent.
});

context.start();

และในทำนองเดียวกัน แอปพลิเคชัน Web Receiver ก็สามารถแจ้งให้ผู้ส่งทราบเกี่ยวกับสถานะได้ ของตัวรับเว็บโดยการส่งข้อความไปยังผู้ส่งที่เชื่อมต่อ เว็บรีซีฟเวอร์ แอปพลิเคชันสามารถส่งข้อความโดยใช้ sendCustomMessage(namespace, senderId, message) ในวันที่ CastReceiverContext ตัวรับเว็บสามารถส่งข้อความถึงผู้ส่งเป็นรายบุคคลเพื่อตอบกลับ ข้อความที่ได้รับ หรือเนื่องจากมีการเปลี่ยนสถานะของแอปพลิเคชัน ทำได้มากกว่าแค่ปลายนิ้วสัมผัส การรับส่งข้อความ (จำกัดที่ 64 KB) ตัวรับเว็บยังอาจประกาศข้อความไปยัง ผู้ส่งที่เชื่อมต่อทั้งหมด

แคสต์สำหรับอุปกรณ์เสียง

ดูคำแนะนำเกี่ยวกับ Google Cast สำหรับอุปกรณ์เสียงเพื่อรับการสนับสนุนเกี่ยวกับเสียง เล่นเท่านั้น

Android TV

ส่วนนี้จะกล่าวถึงวิธีที่ Google Web Receiver ใช้ข้อมูลที่คุณป้อนในการเล่น สามารถใช้ร่วมกับ Android TV ได้

การผสานรวมแอปพลิเคชันของคุณกับรีโมตคอนโทรล

Google Web Receiver ที่ทำงานบนอุปกรณ์ Android TV แปลอินพุตจาก อินพุตควบคุมของอุปกรณ์ (เช่น รีโมตคอนโทรลแบบมือถือ) เป็นการเล่นสื่อ ข้อความที่กำหนดไว้สำหรับเนมสเปซ urn:x-cast:com.google.cast.media เป็น ตามที่อธิบายไว้ในข้อความการเล่นสื่อ บัญชี แอปพลิเคชันต้องรองรับข้อความเหล่านี้เพื่อควบคุมสื่อของแอปพลิเคชัน การเล่นเพื่อใช้การควบคุมการเล่นขั้นพื้นฐานจากการควบคุมของ Android TV อินพุต

หลักเกณฑ์สำหรับความเข้ากันได้กับ Android TV

คำแนะนำและข้อผิดพลาดที่พบบ่อยบางส่วนที่ควรหลีกเลี่ยงมีดังนี้ แอปพลิเคชันของคุณใช้งานร่วมกันได้กับ Android TV:

  • โปรดทราบว่าสตริง User Agent มีทั้งคำว่า "Android" และ "CrKey"; บางเว็บไซต์อาจเปลี่ยนเส้นทางไปยังเว็บไซต์ เฉพาะมือถือ เนื่องจากตรวจพบ "Android" ป้ายกำกับ อย่าคิดเอาเองว่า "Android" ในสตริง user-agent เสมอ แสดงถึงผู้ใช้อุปกรณ์เคลื่อนที่
  • สแต็กสื่อของ Android อาจใช้ GZIP แบบโปร่งใสสำหรับการดึงข้อมูล ตรวจสอบว่า ข้อมูลสื่อของคุณจะตอบสนองต่อAccept-Encoding: gzipได้
  • ระบบอาจทริกเกอร์เหตุการณ์สื่อ HTML5 ของ Android TV ในช่วงเวลาที่ต่างจาก Chromecast อาจแสดงปัญหาที่ซ่อนอยู่ใน Chromecast
  • เมื่ออัปเดตสื่อ ให้ใช้เหตุการณ์ที่เกี่ยวข้องกับสื่อที่เริ่มทำงานโดย <audio>/<video> องค์ประกอบ เช่น timeupdate, pause และ waiting หลีกเลี่ยงการใช้เครือข่าย เหตุการณ์ที่เกี่ยวข้อง เช่น progress, suspend และ stalled เนื่องจากมีแนวโน้ม ขึ้นอยู่กับแพลตฟอร์ม ดูเหตุการณ์สื่อ เพื่อดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการเหตุการณ์สื่อในตัวรับ
  • เมื่อกำหนดค่าใบรับรอง HTTPS ของเว็บไซต์ของผู้รับ อย่าลืมใส่ ใบรับรอง CA ระดับกลาง โปรดดู หน้าทดสอบ Qualsys SSL เพื่อ ยืนยัน: หากเส้นทางการรับรองที่เชื่อถือได้สำหรับเว็บไซต์ของคุณมี CA ใบรับรองที่มีป้ายกำกับว่า "ดาวน์โหลดเพิ่มเติม" ก็จะไม่สามารถโหลดบนระบบ Android ใหม่
  • ในขณะที่ Chromecast แสดงหน้าตัวรับสัญญาณบนระนาบกราฟิก 720p แพลตฟอร์มการแคสต์ซึ่งรวมถึง Android TV อาจแสดงหน้าเว็บได้สูงสุด 1080p ตรวจสอบ หน้าตัวรับสัญญาณจะปรับขนาดได้อย่างสวยงามที่ความละเอียดต่างๆ