การเผยแพร่โปรแกรมติดตั้ง

เอกสารนี้จะแสดงวิธีเผยแพร่เกมใน Google Play Games บน PC โดยใช้โปรแกรมติดตั้งเกม

ในขั้นตอนการติดตั้งของนักพัฒนาแอป โปรแกรมติดตั้งเกมที่คุณระบุจะต้องจัดการการติดตั้ง อัปเดต และถอนการติดตั้งเกม

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

ผสานรวม Google Play Games SDK เข้ากับเกม

แพ็กเกจเกมเป็นไฟล์ WAB

Google Play Games บน PC กำหนดให้คุณต้องอัปโหลดโปรแกรมติดตั้งของเกมไปยัง Google Play Console เป็นไฟล์ Windows App Bundle (WAB) หากต้องการสร้างไฟล์ WAB ให้ ​ทำตามขั้นตอนต่อไปนี้

  1. ดาวน์โหลดเครื่องมือเผยแพร่ของ Play คุณเรียกใช้เครื่องมือนี้ได้ในบรรทัดคำสั่ง Windows หรือ PowerShell

  2. สร้างไฟล์การกำหนดค่าการเผยแพร่ใน Play โดยใช้ชื่อใดก็ได้ เช่น play_publishing_config.xml โดยใช้รูปแบบต่อไปนี้

    <?xml version="1.0" encoding="UTF-8"?>
<play-publishing-config version="1.0">
  <application>
    <package-name>PACKAGE_NAME</package-name>
    <version-name>VERSION_NAME</version-name>
  </application>
  <installer requiresElevation=INSTALLER_REQUIRES_ELEVATION>
    <path>INSTALLER_PATH</path>
    <installation-path-registry-location>
      <key-name>UNIQUE_REGISTRY_PATH</key-name>
      <value-name>InstallLocation</value-name>
    </installation-path-registry-location>
  </installer>
  <launcher requiresElevation=LAUNCHER_REQUIRES_ELEVATION>
    <launch-path-registry-location>
      <key-name>UNIQUE_REGISTRY_PATH</key-name>
      <value-name>InstallLocation</value-name>
    </launch-path-registry-location>
    <executable-invocation>
      <filename>RELATIVE_PATH_TO_LAUNCHER_EXE</filename>
      <arguments>LAUNCHER_ARGS_IF_ANY</arguments>
    </executable-invocation>
  </launcher>
  <uninstaller requiresElevation=UNINSTALLER_REQUIRES_ELEVATION>
    <uninstall-path-registry-location>
      <key-name>UNIQUE_REGISTRY_PATH</key-name>
      <value-name>UninstallString</value-name>
    </uninstall-path-registry-location>
  </uninstaller>
</play-publishing-config>

    แทนที่ค่าต่อไปนี้

    • PACKAGE_NAME: ชื่อแพ็กเกจของเกม นี่คือตัวระบุที่ไม่ซ้ำกันซึ่งจะเชื่อมโยงกับเกมของคุณใน Google Play เช่น com.yourcompany.yourgame ชื่อแพ็กเกจต้องเป็นไปตามกฎต่อไปนี้
      • ต้องมีอย่างน้อย 2 ส่วน (จุด 1 จุดขึ้นไป)
      • แต่ละกลุ่มต้องขึ้นต้นด้วยตัวอักษร
      • อักขระทั้งหมดต้องเป็นตัวอักษรและตัวเลขคละกันหรือขีดล่าง ([a-zA-Z0-9_])

    • VERSION_NAME: สตริงเวอร์ชันของเกม ซึ่งอาจเป็นสตริงใดก็ได้ แต่ต้องไม่ซ้ำกันใน WAB ทั้งหมดที่อัปโหลดสำหรับเกมของคุณ เช่น 1.0, 1.0.1-beta, 2025.11.24, v1.rc1

      • INSTALLER_REQUIRES_ELEVATION: ระบุว่าต้องเรียกใช้ไฟล์ปฏิบัติการของโปรแกรมติดตั้งในฐานะผู้ดูแลระบบเพื่อดำเนินการติดตั้งให้เสร็จสมบูรณ์หรือไม่

        • "true": เรียกใช้ไฟล์ที่เรียกใช้งานได้ในฐานะผู้ดูแลระบบ
        • "false": เรียกใช้ไฟล์ที่เรียกใช้งานได้ในฐานะผู้ใช้ปัจจุบัน

      • INSTALLER_PATH: เส้นทางไปยังไฟล์โปรแกรมติดตั้ง ภายใน WAB เส้นทางนี้อาจเป็นสัมบูรณ์หรือสัมพัทธ์กับ ไดเรกทอรีระดับบนสุดของการกำหนดค่าการเผยแพร่ใน Play เช่น path\to\test\installer อย่าลืมใช้ Authenticode และการลงนามในโค้ดเพื่อลงนามใน ไฟล์ปฏิบัติการของโปรแกรมติดตั้งเกม

      • UNIQUE_REGISTRY_PATH: คีย์รูทที่จะมี ข้อมูลรีจิสทรีทั้งหมด ต้องไม่ซ้ำกันในเครื่องของผู้ใช้ ซึ่งจะเป็นเส้นทางแบบสัมพัทธ์ที่อยู่ด้านบนของ HKLM เช่น SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Uninstall\\YourUniqueName รายการนี้จะสร้างคีย์รูทภายใต้ HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall\YourUniqueName ในเครื่อง Windows 11 แบบ 64 บิต

      • LAUNCHER_REQUIRES_ELEVATION: ระบุว่าต้องเรียกใช้ตัวเรียกใช้หรือไฟล์ปฏิบัติการของเกมในฐานะผู้ดูแลระบบทุกครั้งที่เปิดใช้หรือไม่

        • "true": เรียกใช้ไฟล์ที่เรียกใช้งานได้ในฐานะผู้ดูแลระบบ
        • "false": เรียกใช้ไฟล์ที่เรียกใช้งานได้ในฐานะผู้ใช้ปัจจุบัน

      • RELATIVE_PATH_TO_LAUNCHER_EXE: เส้นทางไปยัง โปรแกรมเรียกใช้หรือไฟล์ปฏิบัติการของเกมภายในไดเรกทอรีการติดตั้ง โดยต้องระบุชื่อไฟล์ปฏิบัติการของตัวเรียกใช้หรือเกม ตัวอย่างเช่น หากตัวเรียกใช้หรือไฟล์เกมชื่อ mygame.exe และอยู่ใน {INSTALL_DIR}\Resources\mygame.exe คุณจะต้องใส่ Resources\mygame.exe

      • LAUNCHER_ARGS_IF_ANY: อาร์กิวเมนต์บรรทัดคำสั่ง ที่ต้องส่งไปยัง Launcher หรือเกม รายการนี้จะระบุหรือไม่ก็ได้

        • ในกรณีที่มีอาร์กิวเมนต์หลายรายการที่เชื่อมโยงกับไฟล์ที่เรียกใช้งานได้ คุณต้องคั่นอาร์กิวเมนต์เหล่านั้นด้วยการเว้นวรรค
        • ต้องนำหน้าอาร์กิวเมนต์ด้วย "--" หรือ "-" หากไฟล์ที่เรียกใช้งานกำหนดไว้

      • UNINSTALLER_REQUIRES_ELEVATION: ระบุว่าต้องเรียกใช้ไฟล์ปฏิบัติการของโปรแกรมถอนการติดตั้งในฐานะผู้ดูแลระบบเพื่อดำเนินการถอนการติดตั้งให้เสร็จสมบูรณ์หรือไม่

        • "true": เรียกใช้ไฟล์ที่เรียกใช้งานได้ในฐานะผู้ดูแลระบบ
        • "false": เรียกใช้ไฟล์ที่เรียกใช้งานได้ในฐานะผู้ใช้ปัจจุบัน

    ตัวอย่างไฟล์กำหนดค่าการเผยแพร่ใน Play

    ลองพิจารณาเกมชื่อ MyGame ซึ่งมีโปรแกรมติดตั้งเกม game_installer.exe และตัวเรียกใช้เกม launcher.exe ตัวอย่างยังแสดงวิธีใช้ CDATA ด้วย play_publishing_config.xml จะมีลักษณะดังนี้ 

    <?xml version="1.0" encoding="UTF-8"?>

<play-publishing-config version="1.0">
  <application>
    <package-name>com.mycompany.mygame</package-name>
    <version-name>1.0.0</version-name>
  </application>
  <installer requiresElevation="true">
    <path>game_installer.exe</path>
    <installation-path-registry-location>
      <key-name>SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Uninstall\\MySystemWideUniqueKey</key-name>
      <value-name>InstallLocation</value-name>
    </installation-path-registry-location>
  </installer>

  <launcher requiresElevation="true">
    <launch-path-registry-location >
      <key-name>SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Uninstall\\MySystemWideUniqueKey</key-name>
      <value-name>InstallLocation</value-name>
    </launch-path-registry-location>
    <executable-invocation>
      <filename>launcher.exe</filename>
      <arguments><![CDATA[arg1&arg2>arg3]]></arguments>
    </executable-invocation>
  </launcher>

  <uninstaller requiresElevation="true">
    <uninstall-path-registry-location>
      <key-name>SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Uninstall\\MySystemWideUniqueKey</key-name>
      <value-name>UninstallString</value-name>
    </uninstall-path-registry-location>
  </uninstaller>
</play-publishing-config>

  3. เรียกใช้เครื่องมือเผยแพร่ Play ในบรรทัดคำสั่งของ Windows หรือ Powershell

    playpublishingtool.exe build-installer-bundle --input=PLAY_PUBLISHING_CONFIG_PATH --output=WAB_OUTPUT_PATH

    หากต้องการเขียนทับไฟล์ WAB ที่มีอยู่ซึ่งมีชื่อเดียวกัน ให้ใช้อาร์กิวเมนต์ --force

    playpublishingtool.exe build-installer-bundle --input=PLAY_PUBLISHING_CONFIG_PATH --output=WAB_OUTPUT_PATH --force

    แทนที่ค่าต่อไปนี้

    • PLAY_PUBLISHING_CONFIG_PATH: เส้นทางไปยังการกำหนดค่าการเผยแพร่ใน Play เช่น path\to\play_publishing_config.xml
    • WAB_OUTPUT_PATH: เส้นทางไปยังไฟล์ WAB เช่น path\to\output_bundle.wab

    วิธีใช้เครื่องมือเผยแพร่ใน Play

    สมมติว่าคุณมีไบนารีเครื่องมือเผยแพร่ Play playpublishingtool.exe, การกำหนดค่าการเผยแพร่ Play play_publishing_config.xml และโปรแกรมติดตั้งเกม game_installer.exe ในไดเรกทอรีการทำงานปัจจุบัน

    ไดเรกทอรีที่ใช้งานในปัจจุบันควรมีลักษณะดังนี้

    .\
├── game_installer.exe
├── play_publishing_config.xml
├── playpublishingtool.exe

    หากต้องการสร้าง WAB ที่มีชื่อ เช่น installer_bundle.wab ในไดเรกทอรีเดียวกัน คำสั่งจะมีลักษณะดังนี้

    playpublishingtool.exe build-installer-bundle --input=play_publishing_config.xml --output=installer_bundle.wab

    หากใช้--force อาร์กิวเมนต์ คำสั่งจะมีลักษณะดังนี้

    playpublishingtool.exe build-installer-bundle --input=play_publishing_config.xml --output=installer_bundle.wab --force

    หากสำเร็จ คุณควรเห็นเอาต์พุตคล้ายกับตัวอย่างต่อไปนี้

    Successfully built the installer bundle at installer_bundle.wab

    ค้นหาไฟล์ WAB ในโฟลเดอร์ต่อไปนี้

      .\
  ├── game_installer.exe
  ├── installer_bundle.wab
  ├── play_publishing_config.xml
  ├── playpublishingtool.exe

เผยแพร่เกมโดยใช้ Play Console

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

เพิ่มรูปแบบของอุปกรณ์ Google Play Games บน PC

คุณต้องทำตามขั้นตอนนี้เมื่อเผยแพร่เกมเป็นครั้งแรกเท่านั้น

  1. ใน Play Console ที่เมนูด้านซ้าย ให้เลือกทดสอบและ เผยแพร่ > การตั้งค่า > การตั้งค่าขั้นสูง (ลิงก์โดยตรง)

  2. ไปที่แท็บรูปแบบของอุปกรณ์ แล้วเพิ่ม Google Play Games on PC จากเมนูแบบเลื่อนลง + เพิ่มรูปแบบของอุปกรณ์

  3. คลิกปุ่มจัดการที่สอดคล้องกับรูปแบบของอุปกรณ์ Google Play Games บน PC ทางด้านขวา

  4. เลือกตัวเลือกใช้แทร็กเฉพาะสำหรับเกมใน App Bundle ของ Windows

  5. คลิกบันทึก แล้วคลิกบันทึกอีกครั้งในกล่องโต้ตอบการยืนยัน

เปิดการเผยแพร่ที่มีการจัดการ

หากต้องการเปิดการเผยแพร่ที่จัดการ ให้ทำตามขั้นตอนต่อไปนี้

  1. ในหน้าภาพรวมการเผยแพร่ ในส่วนการเผยแพร่ที่จัดการ ให้คลิกเปิดการเผยแพร่ที่จัดการ
  2. กล่องโต้ตอบจะปรากฏขึ้น เปลี่ยนเป็นการเผยแพร่ที่จัดการเปิดอยู่สำหรับแทร็ก
  3. คลิกบันทึก

อัปโหลดไฟล์ WAB

หากต้องการอัปโหลดไฟล์ WAB ให้ทำตามขั้นตอนต่อไปนี้

  1. ใน Play Console ที่เมนูด้านซ้าย ให้เลือก ทดสอบและเผยแพร่ > การตั้งค่าขั้นสูง (ลิงก์โดยตรง)
  2. ในหน้าการตั้งค่าขั้นสูง ให้คลิกแท็บรูปแบบของอุปกรณ์
  3. ในแท็บรูปแบบของอุปกรณ์ ให้คลิก + เพิ่มรูปแบบของอุปกรณ์ แล้วเลือก Google Play Games บน PC เพื่อเพิ่ม
  4. ในส่วน Google Play Games บน PC ให้คลิกจัดการ
  5. เลือกใช้แทร็กเฉพาะสำหรับเกมใน App Bundle ของ Windows
  6. คลิกบันทึก
  7. ใน Play Console ที่เมนูด้านซ้าย ให้เลือก ทดสอบและเผยแพร่ > เวอร์ชันที่ใช้งานจริง (ลิงก์โดยตรง)
  8. ในหน้าเวอร์ชันที่ใช้งานจริง ให้เลือก Google Play Games บน PC (Windows) เท่านั้น จากเมนูแบบเลื่อนลงสำหรับรูปแบบของอุปกรณ์
  9. ในแท็บApp Bundle ของ Windows ให้คลิกแก้ไข แล้วอัปโหลดไฟล์ WAB

กำหนดค่าข้อกำหนดสำหรับ Windows PC

วิธีกำหนดค่าข้อกำหนดของ Windows PC

  1. ใน Play Console ที่เมนูด้านซ้าย ให้เลือก เพิ่มผู้ใช้ > การแสดงข้อมูลผลิตภัณฑ์ใน Store > การตั้งค่า Store (ลิงก์โดยตรง)
  2. ในส่วนข้อกำหนดของพีซี ให้คลิกปุ่มแก้ไขทางด้านขวา
  3. อัปเดตช่อง แล้วคลิกบันทึก

กำหนดค่ากราฟิกการซื้อในแอป

ขั้นตอนนี้เป็นขั้นตอนที่ไม่บังคับ วิธีกำหนดค่ากราฟิกการซื้อในแอป

  1. ใน Play Console ที่เมนูด้านซ้าย ให้เลือก ขยายฐานผู้ใช้ > การแสดงข้อมูลสินค้าใน Store > ข้อมูลสินค้าใน Store(ลิงก์โดยตรง)
  2. ในส่วนข้อมูลสินค้าใน Store เริ่มต้นในแท็บข้อมูล ให้คลิกปุ่ม -> (ลูกศร) ทางด้านขวามือ ระบบจะนำคุณไปยังหน้าข้อมูลสินค้าใน Store เริ่มต้น
  3. ไปที่ส่วน Google Play Games บน PC แล้วอัปโหลดรูปภาพที่ กราฟิกการซื้อในแอปของ Google Play Games บน PC (Windows)
  4. คลิกบันทึก

ส่งการเปลี่ยนแปลงให้ตรวจสอบ

  1. ใน Play Console ที่เมนูด้านซ้าย ให้เลือก ภาพรวมการเผยแพร่
  2. คลิกส่งการเปลี่ยนแปลงเพื่อตรวจสอบในส่วนการเปลี่ยนแปลงที่ยังไม่ได้ส่งให้ตรวจสอบ

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