ฟังก์ชันที่ให้ข้อมูลเกี่ยวกับเซสชัน 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 );
ชื่อ | ประเภท | คำอธิบาย |
iSessionIndex | int | ดัชนีของเซสชันที่ระบุไว้ |
รับ ID ของเซสชัน Steam Remote Play ที่เชื่อมต่ออยู่ในขณะนี้ตรงดัชนีที่ระบุไว้
คืนค่า: uint32
ID เซสชันของเซสชันที่ดัชนีที่ระบุไว้ หรือ 0 หากดัชนีนั้นมีค่าน้อยกว่า 0 หรือมากกว่าหรือเท่ากับ
GetSessionCount()
GetSessionSteamID
CSteamID GetSessionSteamID( uint32 unSessionID );
ชื่อ | ประเภท | คำอธิบาย |
unSessionID | uint32 | ID ของเซสชันที่ต้องการข้อมูล |
รับ SteamID ของผู้ใช้ที่เชื่อมต่ออยู่
คืนค่า: CSteamIDไอดี Steam ของผู้ใช้ที่เชื่อมโยงกับเซสชัน Remote Play โดยปกติแล้วหมายถึงผู้ใช้ที่เข้าสู่ระบบแล้ว หรือเพื่อนในกรณีที่เป็น Remote Play Together
GetSessionClientName
const char *GetSessionClientName( uint32 unSessionID );
ชื่อ | ประเภท | คำอธิบาย |
unSessionID | uint32 | ID ของเซสชันที่ต้องการข้อมูล |
รับชื่อของอุปกรณ์ไคลเอนต์เซสชัน
คืนค่า: const char *
ชื่ออุปกรณ์ที่เกี่ยวข้องกับเซสชัน Remote Play หรือ NULL หาก ID ของเซสชันไม่ถูกต้อง
GetSessionClientFormFactor
ESteamDeviceFormFactor GetSessionClientFormFactor( uint32 unSessionID );
ชื่อ | ประเภท | คำอธิบาย |
unSessionID | uint32 | ID ของเซสชันที่ต้องการข้อมูล |
รับฟอร์มแฟกเตอร์ของอุปกรณ์ไคลเอนต์เซสชัน
คืนค่า: ESteamDeviceFormFactorฟอร์มแฟกเตอร์ของอุปกรณ์ที่เกี่ยวข้องกับเซสชัน Remote Play หรือ
k_ESteamDeviceFormFactorUnknown
หาก ID ของเซสชันไม่ถูกต้อง
true หาก ID ของเซสชันมีค่าถูกต้อง มิฉะนั้นจะเป็น
falsebool 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 );
ชื่อ | ประเภท | คำอธิบาย |
unSessionID | uint32 | ID ของเซสชันที่ต้องการข้อมูล |
pnResolutionX | int | ตัวชี้ไปยังค่าตัวแปรที่ต้องกรอกค่าความกว้างความละเอียดของอุปกรณ์ |
pnResolutionY | int | ตัวชี้ไปยังค่าตัวแปรที่ต้องกรอกค่าความสูงความละเอียดของอุปกรณ์ |
รับความละเอียดภาพในหน่วยพิกเซลของอุปกรณ์ไคลเอนต์เซสชัน ค่านี้ตั้งไว้ที่ 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_RunCallbacksSteamRemotePlaySessionConnected_t
ชื่อ | ประเภท | คำอธิบาย |
m_unSessionID | uint32 | ID เซสชันของเซสชันที่เพิ่งเชื่อมต่อ |
SteamRemotePlaySessionDisconnected_t
ชื่อ | ประเภท | คำอธิบาย |
m_unSessionID | uint32 | ID เซสชันของเซสชันที่เพิ่งตัดการเชื่อมต่อ |
Enums
ค่าเหล่านี้เป็นอีนิวเมอเรตที่กำหนดขึ้นเพื่อใช้กับ ISteamRemotePlay
ESteamDeviceFormFactor
ฟอร์มแฟกเตอร์ของอุปกรณ์
ชื่อ | ค่า | คำอธิบาย |
k_ESteamDeviceFormFactorUnknown | 0 | ฟอร์มแฟกเตอร์ของอุปกรณ์ไม่พร้อมใช้งาน |
k_ESteamDeviceFormFactorPhone | 1 | อุปกรณ์นี้คือโทรศัพท์หรืออุปกรณ์มือถือขนาดเล็กอื่น ๆ ที่มีหน้าจอสัมผัส |
k_ESteamDeviceFormFactorTablet | 2 | อุปกรณ์นี้คือแท็บเล็ตหรืออุปกรณ์มือถือขนาดใหญ่อื่น ๆ ที่มีหน้าจอสัมผัส |
k_ESteamDeviceFormFactorComputer | 3 | อุปกรณ์นี้คือคอมพิวเตอร์เดสก์ท็อปหรือแล็ปท็อป |
k_ESteamDeviceFormFactorTV | 4 | อุปกรณ์นี้คือโทรทัศน์ |