startRecording

Bắt đầu quay màn hình để lưu video của run test.

Hỗ trợ một phần trong Astra Scout

Chỉ Android (quay trên device bằng screenrecord). Step này không có trên iOS. Với iOS Simulator, hãy dùng tính năng quay màn hình của Astra Scout thay cho command trong flow.

Command startRecording bắt đầu quay màn hình của flow test. Dùng command này để thu bằng chứng hình ảnh của các run test, đặc biệt khi debug các chuyển cảnh UI phức tạp hoặc test fail không đều. File video được lưu ở định dạng .mp4.

Lưu ý quan trọng

• Bạn phải dùng command stopRecording để hoàn tất file video.

Tham số

Để dùng startRecording, bạn có thể chỉ đưa tên file cần lưu, hoặc dùng đủ các tham số sau:

Parameter	Type	Mô tả
path	string	Tên file của bản quay, không có phần mở rộng. Có thể gồm thư mục con. Xem Đường dẫn artifact để biết nơi lưu.
label	string	(Không bắt buộc) Nhãn mô tả cho step command, hiển thị trong báo cáo test.
optional	boolean	(Không bắt buộc) Nếu true, command không làm test fail khi không thực hiện được. Mặc định false.

Ví dụ sử dụng

Cách dùng cơ bản

Ví dụ này dùng cú pháp viết tắt để bắt đầu một bản quay sẽ được lưu thành recording.mp4.

appId: yourAppId
---
- launchApp
- startRecording: recording
- stopRecording

Bạn cần dùng command stopRecording để báo Astra Scout dừng quay màn hình device.

Đường dẫn và nhãn tùy chỉnh

Ví dụ này dùng cú pháp mở rộng để chỉ định thư mục, nhãn mô tả cho báo cáo, và đánh dấu command là không bắt buộc để test vẫn tiếp tục ngay cả khi bộ quay video không khởi động được.

- startRecording:
    path: "recordings/user_onboarding"
    label: "Capture onboarding sequence for evidence"
    optional: true

Đường dẫn artifact

Astra Scout ghi đầu ra của command này vào thư mục startRecording trong gói artifact của flow. Xem thư mục artifact của run trong báo cáo.

path phải chỉ tới một file, và không được cố thoát khỏi thư mục artifact. Astra Scout từ chối command với error Invalid path (và flow fail) nếu giá trị:

• chỉ tới một thư mục thay vì file
• đi ra ngoài thư mục đầu ra của command bằng .., như ../escape
• là chuỗi rỗng, xảy ra khi một biến trong đường dẫn cho ra ""

Đường dẫn tuyệt đối được phép miễn là vẫn trỏ đúng thư mục.

Một biến chưa từng được định nghĩa không làm command fail. Nó cho ra undefined, và bản quay được lặng lẽ ghi vào undefined.mp4.

Nếu không ghi được file (ví dụ đầy ổ đĩa hoặc đích chỉ đọc), flow fail với Cannot write startRecording output to ....

Command liên quan

• stopRecording