การบันทึกวิดีโอในเกม Android

หลังจากเลิกใช้งาน API ของ Google Sign-In แล้ว เราจะนำ SDK v1 ของเกมออกในปี 2026 หลังจากเดือนกุมภาพันธ์ 2025 คุณจะเผยแพร่ เกมที่เพิ่งผสานรวมกับ SDK v1 ของ Games ใน Google Play ไม่ได้ เราขอแนะนำให้ใช้ SDK v2 ของ Games แทน
แม้ว่าเกมที่มีอยู่ซึ่งผสานรวมกับ v1 ก่อนหน้านี้จะยังทำงานได้อีก 2-3 ปี แต่เราขอแนะนำให้คุณย้ายข้อมูลไปยัง v2 ตั้งแต่เดือนมิถุนายน 2025 เป็นต้นไป
คู่มือนี้มีไว้สำหรับการใช้ SDK บริการเกมของ Play เวอร์ชัน 1 SDK บริการเกมของ Play เวอร์ชัน 2 ไม่รองรับการบันทึกวิดีโอ

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

คู่มือนี้จะแสดงวิธีติดตั้งใช้งานการบันทึกวิดีโอในเกมโดยใช้บริการเกมของ Google Play คุณจะพบ API ได้ในแพ็กเกจ com.google.android.gms.games.video และ com.google.android.gms.games

ก่อนเริ่มต้น

ก่อนเริ่มใช้ API การบันทึกวิดีโอ ให้ทำดังนี้

• ดาวน์โหลดและตรวจสอบตัวอย่างโค้ด

• ทำความคุ้นเคยกับคำแนะนำที่อธิบายไว้ในรายการตรวจสอบคุณภาพ

ดาวน์โหลดไคลเอ็นต์วิดีโอ

หากต้องการเริ่มใช้ API การบันทึกวิดีโอ เกมของคุณต้องได้รับออบเจ็กต์ VideosClient ก่อน คุณทำได้โดยการเรียกใช้เมธอด Games.getVideosClient() และส่งกิจกรรมและ GoogleSignInAccount สำหรับผู้เล่นปัจจุบัน ดูวิธีดึงข้อมูลบัญชีผู้เล่นได้ที่การลงชื่อเข้าใช้ในเกม Android

หมายเหตุ: คลาส VideosClient ใช้คลาส Task ของบริการ Google Play เพื่อส่งคืนผลลัพธ์แบบอะซิงโครนัส ดูข้อมูลเพิ่มเติมเกี่ยวกับการใช้งานเพื่อจัดการงานแบบมัลติเทรดได้ที่คู่มือนักพัฒนาซอฟต์แวร์ Tasks API

ข้อมูลพื้นฐานเกี่ยวกับ API การบันทึกวิดีโอ

คุณสามารถใช้ API การบันทึกวิดีโอเพื่อผสานรวมประสบการณ์การบันทึกวิดีโอจากภายในเกมได้โดยตรง

ประสบการณ์การบันทึกวิดีโอสำหรับผู้ใช้มีดังนี้

• โอเวอร์เลย์การบันทึกวิดีโอซึ่งมีปุ่ม 3 ปุ่ม ได้แก่

  1. เริ่ม/หยุดบันทึก
  2. เปิด/ปิดไมโครโฟน
  3. เปิด/ปิดกล้องหน้า
  หมายเหตุ: การคลิกหน้าต่างแสดงผลกล้องหน้าบนโอเวอร์เลย์จะแสดงปุ่ม 3 ปุ่มที่กล่าวถึงข้างต้น

• ปุ่มที่นักพัฒนาแอปจัดเตรียมไว้เพื่อเริ่มการบันทึก หรือทริกเกอร์การบันทึกทางเลือก

• ข้อความโทสต์ที่คลิกได้ซึ่งจะปรากฏขึ้นเมื่อสิ้นสุดการบันทึก เพื่อให้ผู้เล่นสามารถ อัปโหลดวิดีโอไปยัง YouTube หรือดูวิดีโอผ่านแอป Photos (หมายเหตุ: วิดีโอที่บันทึกไว้จะจัดเก็บไว้ในหมวดหมู่ ScreenCasts ใน Photos)

เปิดโอเวอร์เลย์การบันทึกวิดีโอ

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

1. เรียกใช้เมธอด VideosClient.getCaptureOverlayIntent()
2. หากการเรียกใช้สำเร็จ บริการเกมของ Google Play จะแสดงออบเจ็กต์ Task ซึ่งจะโหลด Intent แบบอะซิงโครนัสเพื่อเปิดใช้โอเวอร์เลย์การบันทึกวิดีโอ
3. ใช้ Intent จากขั้นตอนก่อนหน้าเพื่อเริ่มกิจกรรม

ตัวอย่างวิธีแสดงโอเวอร์เลย์การบันทึกวิดีโอมีดังนี้

private static final int RC_VIDEO_OVERLAY = 9011;

public void showVideoOverlay(View myview) {
  Games.getVideosClient(this, GoogleSignIn.getLastSignedInAccount(this))
      .getCaptureOverlayIntent()
      .addOnSuccessListener(new OnSuccessListener<Intent>() {
        @Override
        public void onSuccess(Intent intent) {
          startActivityForResult(intent, RC_VIDEO_OVERLAY);
        }
      });
}

เคล็ดลับในการใช้ข้อมูลการบันทึกวิดีโอ

API การบันทึกวิดีโอช่วยให้คุณผสานรวมประสบการณ์การบันทึกวิดีโอในเกมได้โดยตรง

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