VisionCenterDEVELOPER

EA ทุกตัวในระบบใช้ SDK กลางตัวเดียวกัน SDK ทำงานพื้นฐานให้ครบ คุณเขียนแค่กลยุทธ์

1เริ่มต้น (5 นาที)#

1. คัดลอกโฟลเดอร์ Include/VisionCenter/ ไปไว้ที่ MQL5/Include/VisionCenter/
2. คัดลอก Examples/VC_Example.mq5 ไปเป็นจุดตั้งต้นของ EA ใหม่
3. เพิ่ม 4 จุดนี้ใน EA (ถ้าเริ่มจาก EA ตัวอย่าง มีครบแล้ว)

#include "MyEA_vc_manifest.mqh"          // ① ไฟล์ที่ vc_build.py สร้าง - ต้องอยู่ก่อน SDK
#include <VisionCenter/VisionCenter.mqh> // ② SDK

int OnInit()
  {
   if(!VC_Init("MyEA", "1.00")) return INIT_FAILED;   // ③ ชื่อ EA (ไม่มีช่องว่าง) + รุ่น
   VC_SetMagicRange(Magic, Magic + 9);                 //    magic ทุกตัวที่ EA นี้ใช้
   ...
  }
void OnDeinit(const int r) { VC_Deinit(r); }
void OnTimer()             { VC_Timer(); }             // SDK ตั้ง timer 1 วินาทีให้เอง

void OnTick()
  {
   bool stopped = VC_GuardTick(DDCutPct, DDCutManual, DailyTarget);   // ตัด DD / กำไรครบ (เรียกทุก tick)
   ... ดูแลไม้ที่เปิดอยู่ (trailing, ปิดตามสัญญาณ) ได้เสมอ ...
   if(stopped || !VC_CanOpenNew()) return;             // ④ ห้ามเปิดไม้ใหม่เมื่อไม่มีสิทธิ์
   ... เปิดไม้ใหม่ ...
  }

2เขียน input ให้หน้าเว็บวาดถูก#

comment ท้ายบรรทัด = ชื่อที่โชว์ (ภาษาไทย ทั้งบนเว็บและในหน้า Inputs ของ MT5) ส่วนค่าตั้งของเว็บเขียนในบรรทัด //@vc ด้านบน หน้าต่าง MT5 ของลูกค้าจะได้สะอาด

//@vc en=01 - Main settings
input group "01 - ตั้งค่าหลัก"

//@vc en=Risk per trade (% of balance) | main | edit=live | who=customer | min=0.1 max=5 step=0.1 | risk=higher | help=ทุน 10,000 ตั้ง 1% = ยอมเสียไม่เกิน 100 ต่อไม้ | help_en=Balance 10,000 at 1% = at most 100 lost per trade
input double RiskPct = 1.0; // ความเสี่ยงต่อไม้ (% ของทุน)

//@vc en=Fast EMA | edit=locked
input int FastEMA = 20; // EMA เร็ว

enum (ตัวเลือก): ใส่ //@vc en=... เหนือแต่ละรายการ และ comment ท้ายบรรทัดเป็นชื่อไทย

enum MY_MODE
  {
   //@vc en=Conservative
   MODE_SAFE = 0, // ระมัดระวัง
   //@vc en=Aggressive
   MODE_FAST = 1  // เร่งกำไร
  };

6 ตั้งค่าหลักมาตรฐาน (ต้องมีทุก EA)#

คัดลอกจาก VC_Example.mq5 ได้เลย ชื่อตัวแปรเปลี่ยนได้ แต่ต้องมีครบ 6 เรื่อง และต้องใส่ main

3สร้างรายการ input (manifest) ก่อนคอมไพล์ทุกครั้ง#

python tools/vc_build.py MyEA.mq5

• ได้ไฟล์ MyEA_vc_manifest.mqh ข้าง EA แล้วจึงคอมไพล์
• ซอร์ส .mq5 อยู่ที่เครื่องคุณเท่านั้น ระบบรับแค่ .ex5

4ทดสอบ#

• Backtest: ใน Strategy Tester SDK ปล่อยให้เทรดเสมอ (ไม่ต่อเน็ต) backtest ได้ตามปกติ
• รันสดก่อนอัปโหลด: วางบนกราฟบัญชี demo มุมซ้ายล่างจะขึ้น VisionCenter · VC-01 · บัญชี … ยังไม่ได้ขอใช้ EA นี้ และ EA ต้องไม่เปิดไม้ แปลว่าตัวล็อกทำงาน
• ต้องเพิ่ม https://app.<โดเมน> ใน Tools › Options › Expert Advisors › Allow WebRequest (ถ้าไม่เพิ่ม จะขึ้น VC-10)

5อัปโหลด#

ที่ dev.<โดเมน> › อัปโหลด EA › เลือกไฟล์ .ex5 + เขียนว่ารุ่นนี้เปลี่ยนอะไร (หน้าอัปโหลดกำลังสร้าง)

ด่านตรวจอัตโนมัติ (ไม่ผ่าน = ตีกลับพร้อมเหตุผล)

6ข้อห้าม#

7รหัสข้อความ VC-xx#

ข้อความที่ SDK แสดงมุมซ้ายล่างของกราฟ

Aภาคผนวก: ตัวล็อกทำงานยังไง#

• EA ส่ง เลขบัญชี + ชื่อเซิร์ฟเวอร์โบรก + ชื่อ EA + รุ่น + รหัสเครื่อง + nonce ไปที่ /api/lic ทุก 5 นาที (ถ้ายังไม่ผ่าน ทุก 1 นาที)
• เซิร์ฟเวอร์ตอบพร้อมลายเซ็น RSA-2048 EA ตรวจด้วยกุญแจสาธารณะที่ฝังใน SDK คนที่ไม่มีกุญแจลับปลอมคำตอบไม่ได้
• คำตอบล่าสุดที่ผ่านเก็บไว้ในเครื่อง เปิด MT5 ใหม่ตอนเน็ตหลุดยังเทรดต่อได้ในช่วงผ่อนผัน 24 ชม.

Bภาคผนวก: โปรโตคอลไลเซนส์ (v0.1)#

SDK จัดการส่วนนี้ให้ทั้งหมด ไม่ต้องเขียนเอง ใส่ไว้ให้รู้ว่าข้างในทำอะไร

คำขอ

POST {VC_HOST}/api/lic
Content-Type: application/json

{ login, server, ea, ver, inst, nonce, sdk }

คำตอบ (HTTP 200)

ok

1 = ใช้ได้, 0 = ไม่ได้

code

รหัส VC-xx

login server ea inst

ค่าที่ส่งไป สะท้อนกลับมาให้ EA ตรวจ

until

วันหมดอายุ YYYY-MM-DDTHH:MM:SSZ หรือว่าง ""

srv_time

เวลาเซิร์ฟเวอร์ (unix)

nonce

ค่าเดียวกับที่ EA ส่งไป

lang

th หรือ en ภาษาของข้อความบนกราฟ

sig

ลายเซ็น base64 (ดูด้านล่าง)

ลายเซ็น

sig = base64 ของ RSA-PKCS1 v1.5 + SHA-256 บนข้อความ UTF-8 นี้ (ok เขียนเป็น 1/0)

ok|code|login|server|ea|inst|until|srv_time|nonce

ช่องทางส่ง

1. ลอง WebRequest ก่อน
2. ถ้าได้ error 4014 (URL ไม่อยู่ในรายการอนุญาต) EA เปลี่ยนไปใช้ ช่องทางไฟล์ เพราะเครื่องที่ระบบดูแลรัน MT5 บน Wine ซึ่งจำรายการอนุญาตไว้ไม่ได้
3. ช่องทางไฟล์: EA เขียน MQL5/Files/vc_lic_req.json (คำขอ + t) โปรแกรม feeder ของเครื่องส่งต่อให้เซิร์ฟเวอร์ แล้วเขียนคำตอบลง vc_lic_resp.json โดยไม่แก้อะไร EA รับคำตอบเมื่อ nonce ตรงและลายเซ็นผ่านเท่านั้น
4. ไม่มีคำตอบใน 30 วิ = ไม่มี feeder: เครื่องลูกค้าที่ไม่ได้เพิ่ม URL จะขึ้น VC-10

Cภาคผนวก: ไฟล์ในชุด SDK#