Nội dung khoá đào tạo

Tài liệu này là một phần của SDK Revit. Nó cung cấp giới thiệu về việc triển khai các ứng dụng add-in Revit bằng cách sử dụng Revit Platform API.

Trước khi tạo một ứng dụng add-in API Revit Platform, hãy đọc qua hướng dẫn và thử mã mẫu. Nếu bạn đã có một số kinh nghiệm với Revit Platform API, bạn có thể chỉ cần xem lại các phần Ghi chú và Khắc phục sự cố.

Giới thiệu về Revit Platform API (Introduction to the Revit Platform API)

Hai chương đầu tiên giới thiệu về Revit Platform API và cung cấp tổng quan về Hướng dẫn Sử dụng.

• Chào mừng đến với Revit Platform API – Giới thiệu về Revit Platform API và kiến thức cơ bản cần có trước khi bạn tạo add-in đầu tiên.
• Bắt đầu – Hướng dẫn từng bước để tạo ứng dụng add-in “Hello World” đầu tiên của bạn bằng Visual Studio 2019 và bốn hướng dẫn khác về các chức năng chính của add-in.

Các chủ đề cơ bản (Basic Topics)

Những chương này bao gồm các cơ chế và chức năng cơ bản của Revit Platform API.

• Tích hợp Add-In – Thảo luận về cách một add-in được tích hợp vào giao diện người dùng Revit và được gọi bởi các lệnh người dùng hoặc các sự kiện cụ thể của Revit như khi khởi động chương trình.
• Ứng dụng và Tài liệu – Lớp Application và Document tương ứng đại diện cho ứng dụng Revit và tệp dự án trong Revit Platform API. Chương này giải thích các khái niệm cơ bản và liên kết đến các chương và phần liên quan.
• Các yếu tố cơ bản – Phần lớn dữ liệu trong một dự án Revit nằm trong một tập hợp các Yếu tố (Elements). Chương này thảo luận về cơ chế cơ bản của Element, phân loại và các tính năng.
• Lọc – Lọc được sử dụng để lấy một tập hợp các phần tử từ tài liệu.
• Lựa chọn – Làm việc với tập hợp các phần tử đã chọn trong một tài liệu.
• Tham số – Hầu hết thông tin về phần tử được lưu trữ dưới dạng Tham số (Parameters). Chương này thảo luận về chức năng của Tham số.
• Bộ sưu tập – Các loại bộ sưu tập tiện ích như Mảng (Array), Bản đồ (Map), Bộ sưu tập (Set), và các Bộ lặp (Iterators) liên quan.

Các chủ đề về phần tử (Element Topics)

Các phần tử được giới thiệu dựa trên phân loại phần tử. Hãy chắc chắn rằng bạn đã đọc các chương về Các yếu tố cơ bản và Tham số trước khi đọc về các phần tử riêng lẻ.

• Chỉnh sửa phần tử – Tìm hiểu cách di chuyển, xoay, xóa, gương, nhóm và sắp xếp các phần tử.
• Tường, Sàn, Trần, Mái và Các lỗ mở – Thảo luận về các phần tử, các loại phần tử tương ứng đại diện cho xây dựng tại chỗ và các loại lỗ mở khác nhau trong API.
• Các instance Family – Tìm hiểu về mối quan hệ giữa family và instance family, các tính năng của family và instance family, và cách tải hoặc tạo chúng.
• Tạo Family – Tìm hiểu về việc tạo và chỉnh sửa các tài liệu Family của Revit.
• Thiết kế khái niệm – Thảo luận về cách tạo hình học phức tạp và các dạng trong tài liệu Revit Conceptual Mass.
• Các phần tử dữ liệu và thông tin – Tìm hiểu cách thiết lập lưới, thêm mức (level), sử dụng các tùy chọn thiết kế và hơn thế nữa.
• Các phần tử chú thích – Thảo luận về chú thích tài liệu bao gồm thêm kích thước, đường chi tiết, thẻ và ký hiệu chú thích.
• Vẽ phác thảo – Các chức năng vẽ phác thảo bao gồm các lớp phác thảo 2D và 3D như SketchPlane, ModelCurve, GenericForm và hơn thế nữa.
• Chế độ xem – Tìm hiểu về các cách khác nhau để xem mô hình và các thành phần và cách thao tác chế độ xem trong API.
• Vật liệu – Dữ liệu vật liệu là một phần tử xác định các vật liệu vật lý được sử dụng trong dự án cũng như kết cấu, màu sắc và hơn thế nữa.

Các chủ đề nâng cao (Advanced Topics)

• Hình học – Thảo luận về các loại liên quan đến đồ họa trong API được sử dụng để mô tả biểu diễn đồ họa của mô hình bao gồm ba lớp mô tả và lưu trữ thông tin hình học.
• Địa điểm và Vị trí – Định nghĩa vị trí dự án bao gồm thành phố, quốc gia, vĩ độ và kinh độ.
• Tham số chia sẻ – Tham số chia sẻ là các tệp văn bản bên ngoài chứa các thông số kỹ thuật. Chương này giới thiệu cách truy cập tham số chia sẻ thông qua Revit Platform API.
• Giao dịch – Giới thiệu hai cách sử dụng Giao dịch và các giới hạn mà bạn phải xem xét khi sử dụng Giao dịch.
• Sự kiện – Thảo luận về cách tận dụng các sự kiện của Revit.
• Cập nhật Mô hình Động – Tìm hiểu cách sử dụng các bộ cập nhật để thay đổi mô hình phản ứng với các thay đổi trong tài liệu.
• Đăng và Xử lý lỗi – Tìm hiểu cách đăng lỗi và tương tác với cơ chế xử lý lỗi của Revit.
• Hiển thị Phân tích – Cách hiển thị kết quả phân tích trong một dự án Revit.

Chuyên môn cụ thể (Discipline Specific)

Revit bao gồm các tính năng chuyên môn cho kiến trúc, kỹ thuật kết cấu và kỹ thuật cơ điện (MEP). Một số API chỉ hoạt động cho các tập hợp tính năng cụ thể.

• Kiến trúc – Thảo luận về các API cụ thể cho các tính năng kiến trúc của Revit.
• Kỹ thuật kết cấu – Thảo luận về các API cụ thể cho các tính năng kỹ thuật kết cấu của Revit.
• Kỹ thuật MEP – Thảo luận về các API cụ thể cho các tính năng cơ điện, điện và ống nước của Revit.

Khác (Other)

• Thuật ngữ – Các định nghĩa về thuật ngữ được sử dụng trong tài liệu này.
• Phụ lục – Thông tin bổ sung như Các câu hỏi thường gặp, Sử dụng Visual Basic.Net để lập trình và hơn thế nữa.