تضمين 6MM Trading Widget: البدء السريع

أضف محطة التداول إلى صفحة ويب تحتوي على حاوية، وسكريبت v1، وTradingWidget.create().

View as Markdown

تدمج Trading Widget SDK واجهة التداول 6MM داخل صفحة ويب مملوكة للشركاء. أسرع تكامل يتطلب حاوية مرئية، وسكريبت SDK الإنتاج، واستدعاء إلى TradingWidget.create().

قبل أن تبدأ

  • تشغيل المثال من صفحة ويب يمكنها تحميل الموارد من https://app.6mm.com.
  • إعطاء حاوية الأداة عرضا وارتفاعا صريحين.
  • حمل SDK قبل الاتصال TradingWidget.create().
  • تخطيط تدفق المصادقة قبل تمكين ميزات الحساب أو التداول في الإنتاج.

مثال بسيط

1<div id="trading-widget" style="width: 100%; height: 720px"></div>
2
3<script src="https://app.6mm.com/sdk/trading-widget/v1/index.js"></script>
4<script>
5 const widget = TradingWidget.create('#trading-widget', {
6 baseUrl: 'https://app.6mm.com',
7 symbol: 'BTCUSDT',
8 theme: 'dark',
9 locale: 'en',
10 layout: 'default',
11 display: {
12 showHeader: false,
13 showTicker: false,
14 hidden: [],
15 },
16 onReady(event) {
17 console.log('ready', event)
18 },
19 onError(error) {
20 console.error('error', error)
21 },
22 })
23</script>

عندما ينجح التكامل، ينشئ SDK إطار iframe داخل #trading-widget وينادي onReady. التقاط onError أثناء التطوير بحيث تكون إخفاقات التكوين والتحميل مرئية.

SDK الروابط

البيئةURL النص
الإنتاجhttps://app.6mm.com/sdk/trading-widget/v1/index.js

اضبط baseUrl بشكل صريح

عند الاختبار من صفحات مملوكة للشركاء، امرر baseUrl بحيث يشير الiframe دائما إلى نطاق الويب 6MM .

ضوابط العرض

التضمين الشريكي يخفي رأس الحاسوب ومؤشر السوق السفلي بشكل افتراضي. استخدم display عندما تحتاج إلى إظهار مناطق الشل أو إخفاء الحاويات عالية المستوى في صفحة التداول المدمجة.

1display: {
2 showHeader: false,
3 showTicker: false,
4 hidden: ['account'],
5}

حجم الحاوية

السطحالحد الأدنى الموصى به
سطح المكتب1024 × 720
موبايل390 × 700

للتخطيطات المستجيبة، حافظ على سلس العرض وحدد ارتفاعا أدنى مناسبا لكل نقطة توقف. الحاوية ذات الارتفاع الصفري يمكنها تحميل SDK بنجاح مع ترك واجهة التداول غير مرئية.

تحقق من التكامل

  1. تأكد من عودة سكريبت SDK بنجاح في لوحة شبكة المتصفح.
  2. تأكيد onReady الإطلاق بمجرد تهيئة iframe.
  3. اختبر symbolالمكونة وال localeوالموضوع والأقسام المخفية.
  4. تغيير حجم الصفحة عبر نقاط توقف سطح المكتب والهواتف المحمولة.
  5. أكمل اختبارا مصادقا مع مستخدم غير إنتاجي قبل الإطلاق.

القضايا الشائعة

عَرَضما يجب التحقق منه
منطقة الأداة الفارغةتأكد من أن الحاوية تظهر عرضا وارتفاعا.
TradingWidget غير معرفتأكد من تحميل السكريبت v1 قبل إنشاء المكالمة.
الصفحة أو البيئة الخاطئةقم بتعيين baseUrl بشكل صريح وتحقق من البيئة المكونة.
حدث الاستعداد لا يطلق أبداالتقاط onError وفحص طلبات iframe أو السكريبتات المحجوبة.
بيانات الحساب غير متوفرةأكمل تدفق مصادقة الأداة المدعومة.

الخطوات التالية