Soạn hoạt động GeoGebra

Hoạt động GeoGebra nhúng một applet GeoGebra (đồ thị, hình học, không gian 3D) vào bài học để học viên tự kéo thả và quan sát. Bạn có thể thêm nút bấm điều khiển applet, và đặt tiêu chí hoàn thành đọc thẳng từ applet: ví dụ hoạt động tự hoàn thành khi học viên kéo điểm A tới đúng toạ độ (2, 3), hoặc khi hệ số góc m bằng 2.

Ai dùng

• Người soạn khoá (vai trò Người quản lý khoá học, hoặc ai có quyền sửa hoạt động của khoá) có sẵn applet trên geogebra.org hoặc tệp .ggb.
• Loại này chỉ có trong menu Thêm activity khi tổ chức bật module Hoạt động Toán.

Đường vào

Trong Course Builder, dùng nút Thêm activity trong bài học và chọn loại GeoGebra, rồi mở trang sửa hoạt động (/admin/activities/<mã>/edit). Form có ô mô tả và bốn khối: Nguồn nội dung, Cấu hình ứng dụng, Tuỳ chọn hiển thị, Nâng cao (thu gọn sẵn).

Bước 1 — Đề bài và nguồn applet

Mô tả bài toán (tuỳ chọn): đề bài hiện phía trên applet. Viết rõ học viên phải làm gì, vì applet không tự nói ra yêu cầu.

Khối Nguồn nội dung, ô Loại nguồn có ba lựa chọn:

Loại nguồn	Điền gì
Material ID (GeoGebra.org)	Mã cuối đường dẫn geogebra.org/m/..., ví dụ abc12345. Mặc định.
Tệp .ggb	Tải lên tệp .ggb xuất từ GeoGebra, tối đa 10 MB.
Nội dung Base64	Dán chuỗi ggbBase64 xuất từ GeoGebra.

Nên dùng tệp .ggb khi applet do bạn tự dựng: applet trên geogebra.org có thể bị tác giả sửa hoặc xoá, còn tệp đã tải lên thì nằm cùng khoá học và đi theo khi xuất khoá.

Bước 2 — Cấu hình hiển thị

Cấu hình ứng dụng:

• Loại ứng dụng: Đồ thị (Graphing), Hình học (Geometry), Không gian 3D, Classic. Đổi loại thì ba công tắc thanh công cụ, ô nhập đại số, menu được đặt lại theo mặc định của loại đó.
• Chiều rộng (400–2000 px, mặc định 800) và Chiều cao (300–1500 px, mặc định 600).

Tuỳ chọn hiển thị: bật/tắt Hiển thị thanh công cụ, Hiển thị ô nhập đại số, Hiển thị menu, Hiển thị nút reset, Cho phép chuột phải, Cho phép zoom bằng Shift+kéo. Tắt thanh công cụ và ô nhập đại số khi muốn học viên chỉ kéo các đối tượng có sẵn, không vẽ thêm.

Bước 3 — Nút bấm và tiêu chí hoàn thành (khối Nâng cao)

Thêm tương tác

Danh sách Cấu hình API (JSON) → Thêm tương tác. Mỗi tương tác có Loại:

• Nút bấm: hiện thành nút bên dưới applet với Nhãn nút bạn đặt (ví dụ "Hiện gợi ý").
• Listener tự động: chạy khi đối tượng ở ô Theo dõi đối tượng thay đổi (ví dụ mỗi khi học viên kéo điểm M).

Và một Hành động:

Hành động	Làm gì
Eval Command	Chạy lệnh GeoGebra (tên lệnh tiếng Anh, mỗi lệnh một dòng), ví dụ f(x) = 2*x + 1.
Set Value	Đặt giá trị cho một đối tượng.
Show / Hide	Ẩn hoặc hiện một đối tượng.
Set Color	Đổi màu đối tượng (R, G, B từ 0–255).
Set Coordinates	Đặt toạ độ X, Y cho một điểm.
Reset	Đưa applet về trạng thái ban đầu.
New Construction	Xoá tất cả.
Set Undo Point	Đánh dấu điểm hoàn tác.
Check Completion	Kiểm tiêu chí hoàn thành ngay (xem dưới).

Tiêu chí hoàn thành

Thêm tiêu chí ở Tiêu chí hoàn thành → Thêm tiêu chí, rồi chọn Kết hợp tiêu chí bằng: AND (mọi tiêu chí phải đạt) hoặc OR (một tiêu chí đạt là đủ).

Loại tiêu chí	Đạt khi
Giá trị bằng	Giá trị của đối tượng bằng Giá trị kỳ vọng. So khớp tuyệt đối, không có sai số.
Giá trị trong khoảng	Tối thiểu ≤ giá trị ≤ Tối đa.
Đối tượng tồn tại	Đối tượng có trong applet (học viên đã tạo nó).
Đối tượng xác định	Đối tượng có giá trị xác định.
Toạ độ gần điểm	Điểm nằm cách (X, Y) không quá Sai số cho phép (mặc định 0,1).
Số lượng đối tượng	Tổng số đối tượng trong applet bằng Giá trị kỳ vọng.

Tên đối tượng GeoGebra phải gõ đúng tên trong applet, phân biệt hoa thường. Mở applet trong GeoGebra, xem tên ở cửa sổ đại số trước khi điền.

Khi đã có tiêu chí, applet tự kiểm mỗi lần học viên thay đổi applet. Đạt thì hoạt động hoàn thành và hiện "Hoàn thành hoạt động thành công!"; chưa đạt thì hiện "Chưa đúng — hãy kiểm tra lại và thử lại.". Học viên thấy dòng "Hoàn thành bài toán trong GeoGebra để kết thúc hoạt động này." bên dưới applet.

Tham số tuỳ chỉnh

Tham số GeoGebra tuỳ chỉnh (JSON) ghi đè tham số nhúng của GeoGebra, ví dụ {"language": "vi"}. Chỉ dùng khi biết tham số mình cần.

Hoàn thành: chọn một trong ba cách

Mỗi hoạt động GeoGebra phải có ít nhất một đường hoàn thành, nếu không học viên kẹt lại:

Cách	Thiết lập	Khi nào dùng
Tiêu chí tự động	Thêm tiêu chí hoàn thành.	Bài có đáp án đo được trong applet.
Nút "Check Completion" không kèm tiêu chí	Thêm một nút bấm với hành động Check Completion và để trống tiêu chí. Bấm nút là hoàn thành.	Bài khám phá, muốn học viên tự xác nhận đã làm xong.
Hoàn thành thủ công	Bật Cho phép hoàn thành thủ công của hoạt động. Học viên thấy nút Đánh dấu hoàn thành.	Như trên, không cần dựng nút. Xem Thiết lập chung của hoạt động.

Không có tiêu chí, không có nút, không bật thủ công = không bao giờ hoàn thành

Lúc đó dưới applet không có nút hay dòng nhắc nào, và hoạt động đứng mãi ở trạng thái đang học. Với khoá bật học tuần tự, học viên bị chặn ở đây.

Hoạt động có thử thách hoàn thành thì đạt tiêu chí chỉ mở thử thách.

Khối GeoGebra trong nội dung soạn thảo

Ngoài loại hoạt động riêng, mọi trình soạn thảo nội dung (bài đọc, mô tả...) có khối GeoGebra Interactive để chèn applet vào giữa bài. Khối này nhận Material ID, Tệp .ggb hoặc Mã nhúng iframe (dán thẻ <iframe> từ GeoGebra; chỉ thẻ iframe https được giữ lại, mã khác bị lọc bỏ). Khối chỉ để minh hoạ: không có tiêu chí hoàn thành và không ghi tiến độ.

Xuất và nhập khoá

Xuất khoá học mang theo tệp .ggb đã tải lên; nhập ở tổ chức khác thì tệp được ghi lại cùng hoạt động. Applet dùng Material ID thì bản nhập vẫn trỏ tới geogebra.org như cũ.

Lưu ý

• AI không chọn applet. Nút AI gợi ý cho người soạn chỉ viết bản hướng dẫn cho người soạn vào ô "Gợi ý từ AI": applet cần cho học viên thao tác gì, giữ cố định cái gì, tìm bằng từ khoá nào. Xem Dùng AI soạn khoá học.
• Applet tải từ geogebra.org, nên máy học viên phải truy cập được trang đó. Mạng trường chặn geogebra.org thì applet không hiện.
• Thử trước khi xuất bản: ghi danh một tài khoản thử, làm đúng bài và kiểm hoạt động có hoàn thành không. Lỗi hay gặp nhất là gõ sai tên đối tượng trong tiêu chí.

Phía học viên: GeoGebra.