เอกสาร Steamworks
อินเตอร์เฟซ ISteamRemotePlay
ฟังก์ชันที่ให้ข้อมูลเกี่ยวกับเซสชัน Steam Remote Play ซึ่งเป็นการสตรีมเนื้อหาเกมของคุณไปยังคอมพิวเตอร์อีกเครื่องหนึ่ง หรือไปยังแอป Steam Link หรือฮาร์ดแวร์

โปรดดูข้อมูลเพิ่มเติมใน Steam Remote Play

ฟังก์ชันสมาชิก


ฟังก์ชันสมาชิกสำหรับ ISteamRemotePlay จะถูกเรียกผ่านทางฟังก์ชันตัวเข้าถึงส่วนกลาง SteamRemotePlay()

GetSessionCount

uint32 GetSessionCount();
รับข้อมูลจำนวนเซสชัน Steam Remote Play ที่เชื่อมต่ออยู่ในขณะนี้

คืนค่า: uint32
จำนวนเซสชัน Steam Remote Play ที่เชื่อมต่ออยู่ในขณะนี้

ตัวอย่าง:
bool BSteamRemotePlayActive() { uint32 unSessionCount = SteamRemotePlay()->GetSessionCount(); for ( uint32 iIndex = 0; iIndex < unSessionCount; iIndex++ ) { RemotePlaySessionID_t unSessionID = SteamRemotePlay()->GetSessionID( iIndex ); if ( !unSessionID ) { continue; } return true; } return false; }

GetSessionID

uint32 GetSessionID( int iSessionIndex );
ชื่อประเภทคำอธิบาย
iSessionIndexintดัชนีของเซสชันที่ระบุไว้

รับ ID ของเซสชัน Steam Remote Play ที่เชื่อมต่ออยู่ในขณะนี้ตรงดัชนีที่ระบุไว้

คืนค่า: uint32
ID เซสชันของเซสชันที่ดัชนีที่ระบุไว้ หรือ 0 หากดัชนีนั้นมีค่าน้อยกว่า 0 หรือมากกว่าหรือเท่ากับ GetSessionCount()

GetSessionSteamID

CSteamID GetSessionSteamID( uint32 unSessionID );
ชื่อประเภทคำอธิบาย
unSessionIDuint32ID ของเซสชันที่ต้องการข้อมูล

รับ SteamID ของผู้ใช้ที่เชื่อมต่ออยู่

คืนค่า: CSteamID
ไอดี Steam ของผู้ใช้ที่เชื่อมโยงกับเซสชัน Remote Play โดยปกติแล้วหมายถึงผู้ใช้ที่เข้าสู่ระบบแล้ว หรือเพื่อนในกรณีที่เป็น Remote Play Together

GetSessionClientName

const char *GetSessionClientName( uint32 unSessionID );
ชื่อประเภทคำอธิบาย
unSessionIDuint32ID ของเซสชันที่ต้องการข้อมูล

รับชื่อของอุปกรณ์ไคลเอนต์เซสชัน

คืนค่า: const char *
ชื่ออุปกรณ์ที่เกี่ยวข้องกับเซสชัน Remote Play หรือ NULL หาก ID ของเซสชันไม่ถูกต้อง

GetSessionClientFormFactor

ESteamDeviceFormFactor GetSessionClientFormFactor( uint32 unSessionID );
ชื่อประเภทคำอธิบาย
unSessionIDuint32ID ของเซสชันที่ต้องการข้อมูล

รับฟอร์มแฟกเตอร์ของอุปกรณ์ไคลเอนต์เซสชัน

คืนค่า: ESteamDeviceFormFactor
ฟอร์มแฟกเตอร์ของอุปกรณ์ที่เกี่ยวข้องกับเซสชัน Remote Play หรือ k_ESteamDeviceFormFactorUnknown หาก ID ของเซสชันไม่ถูกต้อง

true หาก ID ของเซสชันมีค่าถูกต้อง มิฉะนั้นจะเป็น false
bool BSteamRemotePlayToPhone() { uint32 unSessionCount = SteamRemotePlay()->GetSessionCount(); for ( uint32 iIndex = 0; iIndex < unSessionCount; iIndex++ ) { RemotePlaySessionID_t unSessionID = SteamRemotePlay()->GetSessionID( iIndex ); if ( !unSessionID ) { continue; } ESteamDeviceFormFactor eFormFactor = SteamRemotePlay()->GetSessionClientFormFactor( unSessionID ); if ( eFormFactor == k_ESteamDeviceFormFactorPhone ) { return true; } } return false; }

BGetSessionClientResolution

bool BGetSessionClientResolution( uint32 unSessionID, int *pnResolutionX, int *pnResolutionY );
ชื่อประเภทคำอธิบาย
unSessionIDuint32ID ของเซสชันที่ต้องการข้อมูล
pnResolutionXintตัวชี้ไปยังค่าตัวแปรที่ต้องกรอกค่าความกว้างความละเอียดของอุปกรณ์
pnResolutionYintตัวชี้ไปยังค่าตัวแปรที่ต้องกรอกค่าความสูงความละเอียดของอุปกรณ์

รับความละเอียดภาพในหน่วยพิกเซลของอุปกรณ์ไคลเอนต์เซสชัน ค่านี้ตั้งไว้ที่ 0x0 หากไม่มีความละเอียดให้ใช้ได้

คืนค่า: bool
true หาก ID ของเซสชันมีค่าถูกต้อง มิฉะนั้นจะเป็น false

ตัวอย่าง:
// คำสั่งนี้อาจคืนค่าเป็น false หากอุปกรณ์ระยะไกลไม่ให้ข้อมูลความละเอียดของอุปกรณ์ bool BGetSteamRemotePlayResolution( int *pnX, int *pnY ) { int nMaxResolutionX = 0, nMaxResolutionY = 0; uint32 unSessionCount = SteamRemotePlay()->GetSessionCount(); for ( uint32 iIndex = 0; iIndex < unSessionCount; iIndex++ ) { RemotePlaySessionID_t unSessionID = SteamRemotePlay()->GetSessionID( iIndex ); if ( !unSessionID ) { continue; } int nResolutionX = 0, nResolutionY = 0; SteamRemotePlay()->BGetSessionClientResolution( unSessionID, &nResolutionX, &nResolutionY ); if ( nResolutionX > nMaxResolutionX ) { nMaxResolutionX = nResolutionX; nMaxResolutionY = nResolutionY; } } if ( pnX ) { *pnX = nMaxResolutionX; } if ( pnY ) { *pnY = nMaxResolutionY; } return ( nMaxResolutionX > 0 && nMaxResolutionY > 0 ); }

BStartRemotePlayTogether

bool BStartRemotePlayTogether();

แสดง UI ของ Remote Play Together

คืนค่า: bool
true หากกำหนดค่าให้เกมของคุณเล่นได้กับ Remote Play Together มิฉะนั้น แสดงค่า false.

BSendRemotePlayTogetherInvite

bool BSendRemotePlayTogetherInvite( CSteamID steamIDFriend );
ชื่อประเภทคำอธิบาย
steamIDFriend CSteamIDไอดี Steam ของเพื่อนที่คุณต้องการเชิญ

เชิญเพื่อนมาร่วมเล่นเกมโดยใช้ Remote Play Together

คืนค่า: bool
true หากส่งคำเชิญได้สำเร็จเรียบร้อย มิฉะนั้นจะคืนค่า false

คอลแบ็ก

เหล่านี้คือคอลแบ็กที่สามารถเริ่มต้นโดยการเรียก SteamAPI_RunCallbacks

SteamRemotePlaySessionConnected_t


ชื่อประเภทคำอธิบาย
m_unSessionIDuint32ID เซสชันของเซสชันที่เพิ่งเชื่อมต่อ

SteamRemotePlaySessionDisconnected_t


ชื่อประเภทคำอธิบาย
m_unSessionIDuint32ID เซสชันของเซสชันที่เพิ่งตัดการเชื่อมต่อ

Enums

ค่าเหล่านี้เป็นอีนิวเมอเรตที่กำหนดขึ้นเพื่อใช้กับ ISteamRemotePlay

ESteamDeviceFormFactor

ฟอร์มแฟกเตอร์ของอุปกรณ์

ชื่อค่าคำอธิบาย
k_ESteamDeviceFormFactorUnknown0ฟอร์มแฟกเตอร์ของอุปกรณ์ไม่พร้อมใช้งาน
k_ESteamDeviceFormFactorPhone1อุปกรณ์นี้คือโทรศัพท์หรืออุปกรณ์มือถือขนาดเล็กอื่น ๆ ที่มีหน้าจอสัมผัส
k_ESteamDeviceFormFactorTablet2อุปกรณ์นี้คือแท็บเล็ตหรืออุปกรณ์มือถือขนาดใหญ่อื่น ๆ ที่มีหน้าจอสัมผัส
k_ESteamDeviceFormFactorComputer3อุปกรณ์นี้คือคอมพิวเตอร์เดสก์ท็อปหรือแล็ปท็อป
k_ESteamDeviceFormFactorTV4อุปกรณ์นี้คือโทรทัศน์
  翻译: