Video thời gian thực khiến mọi người đắm chìm trong khung cảnh và âm thanh của sự kết nối giữa con người với nhau, giúp họ tương tác lâu hơn với ứng dụng của bạn
Nhờ có Mạng thời gian thực được xác định bằng phần mềm toàn cầu và thông minh của Agora [], bạn có thể tin tưởng vào chất lượng âm thanh và video cao nhất hiện có
Trang này hiển thị mã tối thiểu bạn cần để tích hợp các tính năng Gọi video có độ trễ thấp, chất lượng cao vào ứng dụng của mình bằng SDK video
Phần này giải thích cách bạn có thể tích hợp các tính năng Gọi video vào ứng dụng của mình. Hình dưới đây cho thấy quy trình làm việc mà bạn cần để tích hợp tính năng này vào ứng dụng của mình
Để bắt đầu một phiên, hãy triển khai các bước sau trong ứng dụng của bạn
Truy xuất mã thông báo. Mã thông báo là một chuỗi do máy tính tạo để xác thực người dùng khi ứng dụng của bạn tham gia kênh. Trong hướng dẫn này, bạn truy xuất mã thông báo của mình từ Bảng điều khiển Agora. Để xem cách tạo máy chủ xác thực cho mục đích phát triển, hãy xem Triển khai quy trình xác thực. Để phát triển trình tạo mã thông báo của riêng bạn và tích hợp nó vào hệ thống IAM sản xuất của bạn, hãy đọc Trình tạo mã thông báo
Tham gia một kênh. Gọi các phương thức để tạo và tham gia một kênh;
Để làm theo thủ tục này, bạn phải có
- Studio Android 4. 1 hoặc cao hơn
- API SDK Android cấp 24 trở lên
- Một thiết bị di động chạy Android 4. 1 hoặc cao hơn
Một Agora và
Một máy tính có kết nối Internet
Đảm bảo rằng không có tường lửa nào đang chặn giao tiếp mạng của bạn
Để tích hợp Gọi video vào ứng dụng của bạn, hãy làm như sau
Trong Android Studio, tạo một dự án Điện thoại và Máy tính bảng, Java Android mới với Hoạt động trống
Sau khi tạo dự án, Android Studio sẽ tự động bắt đầu đồng bộ hóa lớp. Đảm bảo rằng quá trình đồng bộ hóa thành công trước khi bạn tiếp tục
Tích hợp Video SDK vào dự án Android của bạn. Để làm điều này
- Trong
/Gradle Scripts/build.gradle [Module: .app]
, thêm dòng sau vào dướidependencies
_5
dependencies {
_5
...
_5
implementation 'io.agora.rtc::'
_5
...
_5
}
Thay thế
và
bằng các giá trị thích hợp cho bản phát hành mới nhất. Ví dụ,
io.agora.rtc:full-sdk:4.0.1
Bạn có thể lấy thông tin
và
mới nhất bằng cách sử dụng Maven Central Repository Search
- Trong
Thêm quyền truy cập mạng và thiết bị
Trong
/app/Manifests/AndroidManifest.xml
, thêm các quyền sau vào saudependencies
0Để tránh làm xáo trộn mã trong Video SDK, hãy thêm dòng sau vào
dependencies
1dependencies
2
Bạn đã sẵn sàng thêm các tính năng Gọi video vào ứng dụng của mình
Khi người dùng mở ứng dụng, bạn khởi tạo Agora Engine. Khi người dùng nhấn vào một nút, ứng dụng sẽ tham gia hoặc rời khỏi một kênh. Khi một người dùng khác tham gia cùng một kênh, video và âm thanh của họ sẽ được hiển thị trong ứng dụng. Quy trình làm việc đơn giản này cho phép bạn tập trung vào việc triển khai các tính năng của Agora chứ không phải chuông và còi UX
Phần này cho biết cách sử dụng Video SDK để triển khai Gọi video vào ứng dụng của bạn, từng bước
Trong giao diện, tạo khung cho video cục bộ và video từ xa cũng như các phần tử giao diện người dùng để tham gia và rời khỏi kênh. Trong dependencies
3, thay thế nội dung của tệp bằng nội dung sau
Bạn thấy lỗi trong IDE của mình. Điều này là do bố cục này đề cập đến các phương thức mà bạn tạo sau này
Nhập các lớp Android cần thiết và xử lý các quyền của Android
Nhập các lớp Android
Trong
dependencies
4, thêm các dòng sau vào saudependencies
5Xử lý các quyền của Android
Khi ứng dụng của bạn khởi chạy, hãy đảm bảo rằng các quyền cần thiết để chèn tính năng Gọi video vào ứng dụng đã được cấp. Nếu các quyền không được cấp, hãy sử dụng tính năng tích hợp sẵn của Android để yêu cầu chúng;
Trong
dependencies
4, thêm các dòng sau vào trướcdependencies
8dependencies
9Hiển thị cập nhật trạng thái cho người dùng của bạn
Trong
dependencies
4, thêm các dòng sau vào trướcdependencies
8
2_5
dependencies {
_5
...
_5
implementation 'io.agora.rtc::'
_5
...
_5
}
Hình dưới đây cho thấy trình tự lệnh gọi API triển khai Gọi điện video
Để thực hiện logic này, hãy thực hiện các bước sau
Nhập các lớp Video SDK
Trong
dependencies
4, thêm các dòng sau vào sau câu lệnh_5
dependencies {
_5
...
_5
implementation 'io.agora.rtc::'
_5
...
_5
}
4 cuối cùng
5_5
dependencies {
_5
...
_5
implementation 'io.agora.rtc::'
_5
...
_5
}
Khai báo các biến mà bạn sử dụng để tạo và tham gia kênh
Trong
dependencies
4, thêm các dòng sau vào lớp
7_5
dependencies {
_5
...
_5
implementation 'io.agora.rtc::'
_5
...
_5
}
Thiết lập Công cụ Agora
Để triển khai Gọi điện video, bạn sử dụng Video SDK để tạo phiên bản Agora Engine. Trong
dependencies
4, thêm đoạn mã sau vào trướcdependencies
80
Xử lý và phản hồi các sự kiện Agora Engine
Trong
dependencies
4, thêm các dòng sau vào sau2
Kết xuất video từ người dùng từ xa trong kênh
Trong SDK video, bản xem trước từ xa bắt đầu khi người dùng từ xa đăng ký kênh. Khi người dùng từ xa tham gia một kênh, bạn sẽ hiển thị luồng video trong giao diện. Sử dụng
3 để gọi
4 để hiển thị video từ xa. Trong
dependencies
4, thêm đoạn mã sau vào sau6
7
Kết xuất video từ người dùng cục bộ trong kênh
Trong
dependencies
4, thêm các dòng sau vào sau4
0
Tham gia kênh để bắt đầu Gọi video
Khi người dùng cục bộ nhấp vào nút Tham gia, hãy gọi
1. Phương pháp này kết nối an toàn người dùng cục bộ với một kênh bằng cách sử dụng mã thông báo xác thực. Trong
dependencies
4, thêm đoạn mã sau vào sau3
Rời khỏi kênh khi người dùng kết thúc cuộc gọi
Khi ứng dụng của bạn đang chạy, người dùng có thể rời khỏi hoặc tham gia kênh bằng các nút có sẵn trong giao diện người dùng. Khi người dùng nhấp vào Rời khỏi, hãy sử dụng
4 để thoát khỏi kênh. Trong
dependencies
4, thêm4 sau
1
Trong quá trình triển khai này, bạn khởi tạo và hủy Agora Engine khi ứng dụng mở và đóng. Người dùng cục bộ tham gia và rời khỏi một kênh bằng cách sử dụng cùng một phiên bản Agora Engine. Để gửi các luồng video và âm thanh tới Agora, bạn cần đảm bảo rằng người dùng cục bộ cấp quyền truy cập vào camera và micrô trên thiết bị cục bộ
Để bắt đầu và dừng ứng dụng của bạn một cách tao nhã
Kiểm tra xem ứng dụng có đúng quyền không và khởi chạy Agora Engine
Trong
dependencies
4, thay thếdependencies
8 bằng đoạn mã sauDọn dẹp các tài nguyên được sử dụng bởi ứng dụng của bạn
Khi người dùng đóng ứng dụng này, hãy sử dụng
io.agora.rtc:full-sdk:4.0.1
0 để dọn sạch tất cả các tài nguyên bạn đã tạo. Trongdependencies
4, thêmio.agora.rtc:full-sdk:4.0.1
0 saudependencies
8io.agora.rtc:full-sdk:4.0.1
4
Agora khuyên bạn nên chạy dự án này trên thiết bị di động thực, vì một số trình giả lập có thể không hỗ trợ đầy đủ các tính năng của dự án này. Để đảm bảo rằng bạn đã triển khai Gọi video trong ứng dụng của mình
trong Bảng điều khiển Agora
Trong trình duyệt của bạn, điều hướng đến bản trình diễn web Agora và cập nhật ID ứng dụng, Kênh và Mã thông báo với các giá trị cho mã thông báo tạm thời của bạn, sau đó nhấp vào Tham gia
Trong Android Studio, trong
io.agora.rtc:full-sdk:4.0.1
5, hãy cập nhậtio.agora.rtc:full-sdk:4.0.1
6,io.agora.rtc:full-sdk:4.0.1
7 vàio.agora.rtc:full-sdk:4.0.1
8 với các giá trị cho mã thông báo tạm thời của bạnKết nối thiết bị Android vật lý với thiết bị phát triển của bạn
Trong Android Studio, nhấp vào Chạy ứng dụng. Một lúc sau bạn thấy dự án được cài đặt trên thiết bị của mình
Nếu đây là lần đầu tiên bạn chạy dự án, bạn cần cấp quyền truy cập micrô và máy ảnh cho ứng dụng của mình
Phần này chứa thông tin hoàn thành thông tin trong trang này hoặc chỉ cho bạn tài liệu giải thích các khía cạnh khác của sản phẩm này
Nội dung tải xuống chỉ cho bạn cách cài đặt Video SDK theo cách thủ công
Để đảm bảo an ninh liên lạc trong môi trường thử nghiệm hoặc sản xuất, nên sử dụng máy chủ mã thông báo để tạo mã thông báo để đảm bảo an toàn liên lạc, xem Triển khai quy trình xác thực