تحميل gamejolt api - تنزيل كود المصدر gamejolt api

gamejolt api

فئات أخرى

Release 2.1.0: PHP 8.3 Support

تنزيل

مكتبة gamejolt api PHP

https://gamejolt.com

توفر هذه المكتبة تغطية كاملة (باستثناء التجميع) لواجهة برمجة تطبيقات Game Jolt (الجوائز، والنتائج، والجلسات، وما إلى ذلك...) في الوقت الحالي، تتم كتابة هذه المكتبة واختبارها للإصدار 1.2 من واجهة برمجة تطبيقات Game Jolt.

تثبيت

$ composer require " harrk/gamejolt-api "

الاستخدام

أنشئ مثيلًا لـ GamejoltApi وقم بتوفير GamejoltConfig لبدء إجراء استدعاءات API إلى Game Jolt.

 $ gameId = 0 ; // Your game's ID
$ gamePrivaykey = " Your game's private key " ;

$ api = new GamejoltApi ( new GamejoltConfig (
    $ gameId ,
    $ gamePrivaykey
));

نقاط النهاية

فيما يلي أمثلة لكيفية تفاعلك مع كل نقطة نهاية. ضع في اعتبارك أن هذه مجرد أمثلة، وقد لا تستخدم جميع خيارات المعلمات.

ارجع إلى وثائق Game Jolt API أو الكود المصدري لمزيد من الخيارات.

مخزن البيانات

يمكن استخدام Data Store API لتخزين/استرداد البيانات في السحابة.

 // Fetch the value for my-key
$ api -> dataStore ()-> fetch ( ' my-key ' );

// Set the value for my-key to my-value
$ api -> dataStore ()-> set ( ' my-key ' , ' my-value ' );

// Update player-logins by 1
$ api -> dataStore ()-> update ( ' player-logins ' , DataStore:: OPERATION_ADD , 1 );

// Remove my-key
$ api -> dataStore ()-> remove ( ' my-key ' );

// Fetch all keys
$ api -> dataStore ()-> getKeys ();

أصدقاء

لا يمكن استخدام Friends API إلا للعثور على معرفات الأصدقاء للمستخدم حاليًا.

 // Fetch all friend ids for the user
$ api -> friends ()-> fetch ( ' username ' , ' user-token ' );

عشرات

 //Fetch scores
$ api -> scores ()-> fetch ();

//Fetch all score tables
$ api -> scores ()-> tables ();

//Add a gamejolt user's score to the table
$ api -> scores ()-> addUserScore ( ' username ' , ' user_token ' , ' 100 Jumps ' , 100 );

//Add a guest's score to the table
$ api -> scores ()-> addGuestScore ( ' Mr Guest ' , ' 50 jumps ' , 50 );

//Get score rank
$ api -> scores ()-> getRank ( 60 );

الجلسات

 //Open a session for the given user
$ api -> sessions ()-> open ( ' username ' , ' user_token ' );

//Let GJ know the user session is still active
$ api -> sessions ()-> ping ( ' username ' , ' user_token ' , Sessions:: STATUS_ACTIVE );

//Check if the session is still open for user
$ api -> sessions ()-> check ( ' username ' , ' user_token ' );

//Close the session for user
$ api -> sessions ()-> close ( ' username ' , ' user_token ' );

وقت

 //Get GJ's server time
$ api -> time ()-> fetch ();

الجوائز

 //Get all trophies
$ api -> trophies ()-> fetch ( ' username ' , ' user_token ' );

//User has achieved a trophy with ID 1
$ api -> trophies ()-> addAchieved ( ' username ' , ' user_token ' , 1 );

//User unachieved trophy with ID 1
$ api -> trophies ()-> removeAchieved ( ' username ' , ' user_token ' , 1 );

المستخدمين

 //Fetch data on user
$ api -> users ()-> fetch ( ' username ' , ' user_token ' );

//Verify if the user's credentials are correct
$ api -> users ()-> auth ( ' username ' , ' user_token ' );

اصطياد الاستثناءات

فيما يلي مثال على كيفية التقاط الاستثناءات:

 try {
    $ auth = $ api -> users ()-> auth ( ' username ' , ' user_token ' );
} catch ( TimeOutException $ e ) {
    return redirect ()-> route ( ' home ' )-> with ( ' error ' , $ e -> getMessage ());
}