Các hướng dẫn này có hiệu lực từ khi phát hành SDK Unity Ads 4.0.0.
Bạn nên dùng bộ API tốt nhất để đáp ứng nhu cầu của mình vào thời điểm phát triển. Tuy nhiên, Unity khuyên tất cả nhà phát triển nên cập nhật phiên bản SDK mới nhất thường xuyên nhất có thể.
Để đảm bảo Unity Ads phân phối trải nghiệm phát triển tối ưu hóa và đồng nhất, Unity Ads phải tiếp tục phát triển và mở rộng SDK cũng như các lớp API của mình. Khi chúng tôi thích ứng với những thay đổi của nền tảng và thị trường, các lớp API trở nên lỗi thời nên cần được thay thế bằng phiên bản hiệu quả hơn.
Trong trường hợp Unity Ads có ý định xóa bỏ hoặc thay đổi một lớp API theo cách làm gián đoạn chức năng được hỗ trợ trước đó, Unity sẽ nỗ lực:
- Gắn nhãn cho API là deprecated, ghi sự kiện ngừng sử dụng này vào ghi chú bản phát hành và (nếu áp dụng) cập nhật tài liệu và mẫu để cung cấp phương pháp thay thế ưu tiên trong bản phát hành lớn hoặc nhỏ tiếp theo.
- Xóa API không dùng nữa trong bản phát hành lớn trong tương lai; và
- Thực hiện nỗ lực hợp lý để cung cấp thông báo trước ít nhất ba (3) tháng về việc xóa bỏ API không dùng nữa bằng cách sử dụng Thông báo Ngừng sử dụng (tham khảo phần về Thông báo).
Trường hợp ngoại lệ
Trường hợp ngoại lệ của các hướng dẫn ngừng sử dụng nói trên là các trường hợp trong đó:
- Unity Ads phải xóa bỏ API do thay đổi của pháp luật hiện hành hoặc quyền của Unity Ads theo hợp đồng;
- Việc tiếp tục cung cấp tính năng có thể gây ra rủi ro bảo mật, tuân thủ, bảo mật dữ liệu hoặc rủi ro pháp lý khác hoặc khiến Unity và/hoặc đối tác bên thứ ba và khách hàng gặp bất kỳ rủi ro nào về trách nhiệm pháp lý hoặc thiệt hại (do Unity toàn quyền quyết định); hoặc
- Việc tiếp tục cung cấp tính năng có thể mang đến gánh nặng đánh kể về kinh tế hoặc kỹ thuật cho Unity hoặc cho đối tác bên thứ ba và khách hàng (bao gồm làm quá tải hoặc đe dọa tính toàn vẹn, hiệu suất hoặc tính khả dụng của mọi dịch vụ Unity cơ sở) do Unity toàn quyền quyết định.
Thông báo
Nếu API trở nên lỗi thời, Unity Ads sẽ sử dụng nỗ lực chính đáng để cung cấp Thông báo Ngừng sử dụng bằng cách thực hiện theo một hoặc nhiều nội dung sau:
- Thông tin đến nhà phát triển qua bảng điều khiển Unity Ads Monetization. Bài đăng sẽ chứa Thông báo Ngừng sử dụng, API thay thế (nếu có) và phiên bản SDK mục tiêu dùng để xóa;
- Bản cập nhật tài liệu kỹ thuật chính thức chứa API thay thế (nếu có); hoặc
- Nội dung cập nhật của bản ghi thay đổi SDK trong phần có chứa liên kết đến thông tin chi tiết hơn về các lớp hiện không dùng nữa, các lớp thay thế có thể áp dụng và ngày hết hạn sử dụng dự kiến.
Điều nên mong đợi
Các lớp API và tính năng được hỗ trợ của chúng được duy trì theo cách thức tương thích với các phiên bản trước đó bất cứ khi nào có thể. Nếu cần thay đổi một điều gì đó theo cách không tương thích ngược, Unity Ads sẽ tạo tài nguyên, loại media hoặc phiên bản mới, đồng thời tài nguyên hoặc loại media cũ sẽ được duy trì theo chính sách ngừng sử dụng API.
Unity Ads sẽ cung cấp thông tin sau cho tất cả các trường hợp ngừng sử dụng API đã được công bố:
- API cần được xóa bỏ
- Phiên bản SDK mà API không còn dùng
- API được dùng thay cho chức năng tương tự
- Phiên bản SDK mà API đã (hoặc sẽ) bị xóa
- Lý do ngừng sử dụng API
Các thay đổi đối với Hướng dẫn này
Các hướng dẫn này có thể thay đổi mà không cần thông báo và Unity có quyền tùy ý sửa đổi quy trình ngừng sử dụng API bất kỳ lúc nào.
Định nghĩa và khái niệm
Ngừng sử dụng
Các lớp API không dùng nữa vẫn có thể dùng được nhưng không còn được hỗ trợ trong thời gian tới và sẽ bị xóa trong bản phát hành tương lai.
Thông báo Ngừng sử dụng
Cung cấp thông báo cải tiến rằng một lớp API sẽ được thay thế trong bản phát hành SDK sắp tới. Đây là thời điểm thích hợp để các nhà phát triển nâng cấp mã.
Lập phiên bản Ngữ nghĩa
SDK Unity Ads tuân theo các tiêu chuẩn về lập phiên bản ngữ nghĩa. Lớp API chỉ bị xóa trong các bản phát hành phiên bản lớn.
Khả năng tương thích ngược của API
Unity cố gắng mang lại khả năng tương thích ngược cho tất cả các API công khai được ghi lại trong tài liệu tham khảo về API. Các nhà phát triển phải sử dụng API được hỗ trợ được liệt kê trong tài liệu tham khảo về API để đảm bảo khả năng tương thích.