IPlayerService Interface (เอกสาร Steamworks)

เอกสาร Steamworks

IPlayerService Interface

เอกสาร Steamworks > ข้อมูลอ้างอิงในการใช้งาน Steamworks Web API > IPlayerService Interface

ให้เมธอดเพิ่มเติมสำหรับโต้ตอบกับผู้ใช้ Steam

อ่านข้อมูลเกี่ยวกับอินเตอร์เฟซหลักได้ที่ ISteamUser

หมายเหตุ: นี่คืออินเตอร์เฟซให้บริการ การเรียกเมธอดในอินเตอร์เฟซนี้ควรใช้พารามิเตอร์ input_json

หากต้องการเรียนรู้เพิ่มเติมเกี่ยวกับวิธีใช้ Steamworks Web API โปรดอ่าน ภาพรวมของ Web API

GetRecentlyPlayedGames

GET https://partner.steam-api.com/IPlayerService/GetRecentlyPlayedGames/v1/

ชื่อ	ประเภท	จำเป็นต้องใช้	คำอธิบาย
key	string	✔	คีย์การตรวจสอบสิทธิ์ของผู้ใช้ Steamworks Web API
steamid	uint64	✔	ผู้เล่นที่เราสอบถามข้อมูล
count	uint32	✔	จำนวนเกมที่จะคืนค่า (0/ไม่ได้ตั้งค่า: ทุกเกม)

รับข้อมูลเกี่ยวกับเกมที่ผู้เล่นเพิ่งเล่นเมื่อไม่นานมานี้

GetSingleGamePlaytime

GET https://partner.steam-api.com/IPlayerService/GetSingleGamePlaytime/v1/

ชื่อ	ประเภท	จำเป็นต้องใช้	คำอธิบาย
key	string	✔	คีย์การตรวจสอบสิทธิ์ของผู้ใช้ Steamworks Web API
steamid	uint64	✔	ผู้เล่นที่เราสอบถามข้อมูล
appid	uint32	✔	ไอดีแอปที่เราต้องการรับเวลาเล่น

รับข้อมูลเกี่ยวกับเวลาเล่นที่ผู้เล่นใช้กับไอดีแอปรายการเดียว คีย์ WebAPI ต้องเชื่อมโยงกับไอดีแอปนี้จึงจะได้รับผลลัพธ์กลับมา

GetOwnedGames

GET https://partner.steam-api.com/IPlayerService/GetOwnedGames/v1/

ชื่อ	ประเภท	จำเป็นต้องใช้	คำอธิบาย
key	string	✔	คีย์การตรวจสอบสิทธิ์ของผู้ใช้ Steamworks Web API
steamid	uint64	✔	ผู้เล่นที่เราสอบถามข้อมูล
include_appinfo	bool	✔	มีค่า true ถ้าเราต้องการรายละเอียดเพิ่มเติม (ชื่อ, ไอคอน) เกี่ยวกับแต่ละเกม
include_played_free_games	bool	✔	ค่าเริ่มต้นจะไม่รวมเกมฟรี ถ้าตั้งค่านี้ไว้ จะคืนค่าเกมฟรีที่ผู้ใช้เล่นด้วย
appids_filter	uint32	✔	ถ้าตั้งค่าไว้ จะจำกัดชุดผลลัพธ์เฉพาะแอปที่ส่งเข้าไปเท่านั้น

คืนค่ารายการเกมที่ผู้เล่นเป็นเจ้าของหากคุณสามารถเห็นรายละเอียดของเกมที่ผู้เล่นรายนั้นเคยเป็นเจ้าของได้

GetSteamLevel

GET https://partner.steam-api.com/IPlayerService/GetSteamLevel/v1/

ชื่อ	ประเภท	ที่ต้องการ	คำอธิบาย
key	string	✔	คีย์การตรวจสอบสิทธิ์ของผู้ใช้ Steamworks Web API
steamid	uint64	✔	ผู้เล่นที่เราสอบถามข้อมูล

คืนค่าเลเวล Steam ของผู้ใช้

GetBadges

GET https://partner.steam-api.com/IPlayerService/GetBadges/v1/

ชื่อ	ประเภท	จำเป็นต้องใช้	คำอธิบาย
key	string	✔	คีย์การตรวจสอบสิทธิ์ของผู้ใช้ Steamworks Web API
steamid	uint64	✔	ผู้เล่นที่เราสอบถามข้อมูล

รับเหรียญตราที่เป็นของผู้ใช้เฉพาะราย

GetCommunityBadgeProgress

GET https://partner.steam-api.com/IPlayerService/GetCommunityBadgeProgress/v1/

ชื่อ	ประเภท	จำเป็นต้องใช้	คำอธิบาย
key	string	✔	คีย์การตรวจสอบสิทธิ์ของผู้ใช้ Steamworks Web API
steamid	uint64	✔	ผู้เล่นที่เราสอบถามข้อมูล
badgeid	int32	✔	เหรียญตราที่เราสอบถามข้อมูล

รับภารกิจทั้งหมดที่จำเป็นต่อการรับเหรียญตราที่ระบุไว้ และภารกิจที่ทำสำเร็จแล้ว