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

เอกสารนี้จะแสดงวิธีเผยแพร่เกมใน 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: เส้นทางคีย์รีจิสทรีของ Windows ต้องระบุเส้นทางนี้โดยสัมพันธ์กับรีจิสทรีไฮฟ์ เช่น HKEY_LOCAL_MACHINE หรือ HKEY_CURRENT_USER โดยไม่ต้องใส่ชื่อไฮฟ์ ในสตริงเส้นทาง เช่น หากโปรแกรมติดตั้งเขียนถึง HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\Uninstall\YourUniqueName ให้ระบุเฉพาะ Software\Microsoft\Windows\CurrentVersion\Uninstall\YourUniqueName Google Play Games บน PC จะค้นหาเส้นทางนี้ภายใต้ Hive หลายรายการเพื่อค้นหามูลค่าที่จำเป็นสำหรับการเปิดตัวและการถอนการติดตั้ง

       ไฟล์ที่เรียกใช้งานได้ซึ่งระบุใน INSTALLER_PATH ต้องสร้างคีย์รีจิสทรีเหล่านี้ ก่อนการติดตั้งจะเสร็จสมบูรณ์ ต้องสร้างคู่คีย์รีจิสทรีและชื่อค่าที่ระบุในส่วน installation-path-registry-location, launch-path-registry-location และ uninstall-path-registry-location แม้ว่าตัวอย่างจะใช้ InstallLocation และ UninstallString แต่คุณก็ระบุชื่อใดก็ได้ในแท็ก <value-name> เหล่านี้ ตราบใดที่โปรแกรมติดตั้งสร้างรายการรีจิสทรีที่สอดคล้องกันสำหรับทั้ง 3 รายการ Google Play Games บน PC ใช้ค่าเหล่านี้เพื่อเปิดตัวและถอนการติดตั้ง เกม หากเกมของคุณใช้ตัวเรียกใช้ เส้นทางนี้ต้องชี้ไปยังรีจิสทรีคีย์ที่มีข้อมูลการติดตั้งสำหรับตัวเรียกใช้ และค่าในรายการรีจิสทรีที่ระบุโดย launch-path-registry-location ต้องชี้ไปยังไดเรกทอรีของตัวเรียกใช้

       เส้นทางนี้ต้องไม่ซ้ำกันในเครื่องของผู้ใช้ ตัวอย่างเช่น SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\YourUniqueName

       หากโปรแกรมติดตั้งเกมเป็นแอปพลิเคชัน 32 บิตที่ทำงานบน Windows 64 บิต Windows จะใช้การเปลี่ยนเส้นทางรีจิสทรีเพื่อเขียนรายการรีจิสทรี ภายใต้ HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node เช่น การ เขียนไปยัง HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\YourUniqueName จะเปลี่ยนเส้นทางไปยัง HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall\YourUniqueName

     • 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>
       <!-- The package name for your game. -->
       <package-name>com.mycompany.mygame</package-name>
       <!-- The game's version string. -->
       <version-name>1.0.0</version-name>
     </application>
     <!-- If requiresElevation is "true", installer runs as Administrator
          and a UAC prompt is displayed. This is required for system-wide
          installs (e.g., to Program Files) or writing to HKLM. -->
     <installer requiresElevation="true">
       <!-- Path to your installer executable. -->
       <path>game_installer.exe</path>
       <!-- The registry location where the installer writes the installation path. -->
       <installation-path-registry-location>
         <!-- Registry key path (typically under HKLM or HKCU).
              game_installer.exe MUST create this key. -->
         <key-name>SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\MySystemWideUniqueKey</key-name>
         <!-- game_installer.exe, specified in <path>, creates the registry
              value called 'InstallLocation' within
              SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\MySystemWideUniqueKey
              by the time it exits. -->
         <value-name>InstallLocation</value-name>
       </installation-path-registry-location>
     </installer>
   
     <!-- If requiresElevation is "true", launcher runs as Administrator
          and a UAC prompt is displayed on every game launch. -->
     <launcher requiresElevation="true">
       <!-- Specifies the registry location where Google Play Games reads the installation path
            in order to launch the game. -->
       <launch-path-registry-location >
         <!-- Registry key path (typically under HKLM or HKCU) where
              the launch path can be found. -->
         <key-name>SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\MySystemWideUniqueKey</key-name>
         <!-- Google Play Games reads the installation directory from this
              registry value, for example InstallLocation, to launch the game. -->
         <value-name>InstallLocation</value-name>
       </launch-path-registry-location>
       <executable-invocation>
         <!-- Game executable or launcher filename, relative to the
              directory path specified in the InstallLocation registry value. -->
         <filename>launcher.exe</filename>
         <!-- Optional arguments to pass to the executable.
              CDATA is used here to avoid issues with special characters
              like & or >. -->
         <arguments><![CDATA[arg1&arg2>arg3]]></arguments>
       </executable-invocation>
     </launcher>
   
     <!-- If requiresElevation is "true", uninstaller runs as
          Administrator and a UAC prompt is displayed for uninstall. -->
     <uninstaller requiresElevation="true">
       <!-- Registry key where Google Play Games finds the
            uninstallation command. -->
       <uninstall-path-registry-location>
         <!-- Registry key path (typically under HKLM or HKCU) where
              uninstall command can be found. -->
         <key-name>SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\MySystemWideUniqueKey</key-name>
         <!-- game_installer.exe also creates the registry value, for example, 'UninstallString'
              within SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\MySystemWideUniqueKey,
              containing the command Google Play Games executes to uninstall
              the game. -->
         <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 ได้