ภาพรวม

องค์ประกอบ

เอฟเฟกต์

การเริ่มต้นใช้งาน

Chillin Render API ช่วยให้คุณสามารถระบุเนื้อหาวิดีโอและพารามิเตอร์ที่จะถูกเรนเดอร์โดยการกำหนดโครงสร้าง JSON เช่นตัวอย่างด้านล่าง

  • ไปที่ Render Console เพื่อขอเครดิต Render API และสร้างคีย์ Render API ของคุณ

  • ส่งคำขอ POST ไปยังจุดสิ้นสุด Render API พร้อมกับคีย์ API ของคุณ:

curl-example.sh
request.json

API ทำงานในโหมด async และส่งคืนการตอบกลับเช่นนี้:

async_response.json

แนวคิดหลัก

วัตถุ JSON ทั้งหมดจะรวมวัตถุโปรเจกต์วิดีโอ ซึ่งระบุความกว้างของภาพรวม ความสูงของภาพรวม และความละเอียดของวิดีโอ

วัตถุโปรเจกต์ประกอบด้วยพารามิเตอร์พื้นฐานสำหรับการเรนเดอร์วิดีโอ เช่น ความกว้าง ความสูง ระยะเวลา สีพื้นหลัง และอื่นๆ

โปรเจกต์ยังรวมถึงหนึ่งหรือหลายองค์ประกอบ โดยแต่ละองค์ประกอบจะแทนที่ส่วนประกอบของวิดีโอ เช่น วิดีโอ รูปภาพ ข้อความ รูปร่าง เสียง หรือเอฟเฟกต์

แต่ละองค์ประกอบมีพารามิเตอร์เฉพาะสำหรับส่วนประกอบ เช่น ตำแหน่ง ขนาด สี เนื้อหา และอื่นๆ

project.json

พื้นที่ 3D & กล้อง

เอนจินการเรนเดอร์รองรับทั้งองค์ประกอบ 2D และ 3D ในขณะที่ผืนผ้าใบถูกกำหนดด้วย width และ height ในพิกเซล เอนจินจะใช้กล้องมุมมองสำหรับการเรนเดอร์ 3D:

  • ระบบพิกัด: พิกัด x และ y แทนตำแหน่งบนผืนผ้าใบ 2D พิกัด z ควบคุมความลึกในพื้นที่ 3D
  • การฉายแบบพิกเซล-สมบูรณ์: ที่ z=0 หนึ่งหน่วยโลกเท่ากับหนึ่งพิกเซล ทำให้สามารถทำงานร่วมกับการทำงาน 2D ได้
  • การหมุน 3D: องค์ประกอบสามารถหมุนรอบแกน X, Y และ Z โดยใช้คุณสมบัติ rotationX, rotationY และ rotation (แกน Z)

การออกแบบนี้ช่วยให้สามารถผสมผสานองค์ประกอบ 2D และ 3D ได้อย่างราบรื่นในโปรเจกต์เดียว องค์ประกอบ 2D แบบดั้งเดิม (ที่ z=0) จะเรนเดอร์ได้เหมือนเดิม ในขณะที่องค์ประกอบ 3D สามารถวางและหมุนในพื้นที่สามมิติได้

ตัวอย่างองค์ประกอบ 3D

นี่คือตัวอย่างง่ายๆ ขององค์ประกอบลูกบาศก์ 3D:

3d-cube-example.json

ความแตกต่างที่สำคัญจากองค์ประกอบ 2D:

  • type: "3D" ระบุว่านี่เป็นองค์ประกอบ 3D
  • z, rotationX, rotationY, และ scaleZ เปิดใช้งานการเปลี่ยนแปลง 3D
  • geometryType ระบุรูปร่าง 3D (ลูกบาศก์, ลูกบอล, กระบอก, ฯลฯ)
  • geometryColor ตั้งค่าสีพื้นฐานของเรขาคณิต 3D

สำหรับรายละเอียดเพิ่มเติมเกี่ยวกับองค์ประกอบ 3D โปรดดูที่เอกสาร 3D Element

JSON Schema

คำขอ JSON ของคุณต้องปฏิบัติตาม JSON schema ที่กำหนดในเอกสารนี้อย่างเคร่งครัด คุณสามารถทดสอบและสร้างคำขอ JSON ที่สอดคล้องกันใน Chillin Video Editor