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

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

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

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

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

ก่อนเริ่มใช้ Video Recording API ให้ทำดังนี้

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

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

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

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

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

ข้อมูลพื้นฐานเกี่ยวกับ Video Recording API

คุณสามารถใช้ Video Recording 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 ที่แสดงภาพซ้อนทับของการบันทึกวิดีโอ โปรโมตฟีเจอร์บันทึกวิดีโอผ่านโปรโมชันในเกม พิจารณามอบรางวัลในเกมสำหรับการแชร์การเล่นซ้ำ
ดึงดูดชุมชนผู้เล่นด้วยการแข่งขันรีเพลย์	กระตุ้นให้ผู้เล่นบันทึกและแชร์การเล่นซ้ำของเกมด้วยการแข่งขันการเล่นซ้ำรายสัปดาห์ / รายเดือน / รายปี รับรู้ถึงวิดีโอและครีเอเตอร์ยอดนิยมในเกมหรือผ่านโซเชียลมีเดีย