پلیر امن XAPlayer در لاراول

نصب روی سایت شما۳ دقیقه مطالعه

آموزش اتصال سایت لاراولی به XAPlayer: کلید در .env، یک کنترلر با Http، بررسی خرید با Gate و نمایش پلیر در Blade.

همه‌ی راهنماها

در این آموزش یک مسیر «تماشای دوره» می‌سازید. کنترلر بررسی می‌کند کاربر دوره را خریده، برای او یک توکن کوتاه‌مدت از XAPlayer می‌گیرد و پلیر را در قالب Blade نشان می‌دهد.

پیش از شروع#

  1. در پنل XAPlayer به «تنظیمات» بروید و در بخش «کلید API» یک کلید بسازید. کلید فقط یک بار نمایش داده می‌شود؛ همان لحظه کپی‌اش کنید.
  2. در «سایت‌های مجاز برای نمایش پلیر» نشانی کامل سایت‌تان را اضافه کنید، مثلاً https://academy.example.com. اگر سایت با www هم باز می‌شود، آن را هم اضافه کنید.
  3. شناسه‌ی دوره را بردارید: در «تنظیمات»، بخش «راهنمای نمایش پلیر در سایت شما» دوره را انتخاب کنید تا شناسه‌اش در نمونه‌کد نوشته شود. همان بخش آخر نشانی صفحه‌ی دوره در پنل هم هست.
  4. در مدل Course خودتان ستونی برای شناسه‌ی دوره در XAPlayer داشته باشید؛ در این نمونه xaplayer_course_id.

تنظیمات#

# .env
XAPLAYER_URL=https://xaplayer.ir/api/v1
XAPLAYER_API_KEY=xap_sk_...

مسیر و کنترلر#

// routes/web.php
use App\Http\Controllers\LessonController;

Route::get('/courses/{course}/watch', [LessonController::class, 'show'])
    ->middleware('auth')
    ->name('courses.watch');

آزمایش#

  1. php artisan config:clear را اجرا کنید تا تنظیمات تازه خوانده شود.
  2. با کاربری که دوره را خریده نشانی /courses/1/watch را باز کنید.
  3. با کاربر دیگری همان نشانی را باز کنید؛ باید خطای ۴۰۳ ببینید.

اگر کار نکرد#

نشانهعلت و راه‌حل
جای پلیر خالی است یا مرورگر می‌گوید «اجازه‌ی اتصال ندارد»نشانی سایت در «سایت‌های مجاز» نیست یا با www/بدون www فرق دارد. نشانی دقیق صفحه را اضافه کنید.
خطای ۴۰۱ (unauthorized)کلید API اشتباه است یا کلید تازه‌ای ساخته‌اید و کلید قبلی از کار افتاده. کلید را دوباره کپی کنید.
خطای ۴۰۴ (not_found)شناسه‌ی دوره یا ویدیو اشتباه است یا متعلق به حساب دیگری است.
خطای ۴۰۰ (bad_request)بدنه‌ی درخواست ناقص است: دقیقاً یکی از courseId یا videoId را بفرستید و viewer.id را خالی نگذارید.
پلیر بعد از چند ساعت «زمان صفحه تمام شده» می‌گویدتوکن منقضی شده. هر بار که صفحه باز می‌شود توکن تازه بگیرید و نشانی پلیر را کش نکنید.

XAPlayer را ۱۴ روز رایگان، با ۱۰ لایسنس هدیه امتحان کنید.

دوره‌ی خود را رایگان امتحان کنید