Mã nhóm ứng dụng
public
class
AppSetId
extends Object
java.lang.Object | |
↳ | android.adservices.appsetid.AppSetId |
Mã nhận dạng duy nhất mà người dùng có thể đặt lại cho mỗi thiết bị, mỗi tài khoản nhà phát triển đối với các trường hợp sử dụng quảng cáo không kiếm tiền.
Biểu thị appSetID và phạm vi của appSetId này từ API AppSetIdManager.getAppSetId(Executor, OutcomeReceiver)
. Phạm vi của mã nhận dạng có thể theo ứng dụng
hoặc theo tài khoản nhà phát triển được liên kết với người dùng. AppSetId được sử dụng cho phân tích, thư rác
phát hiện, giới hạn tần suất và các trường hợp sử dụng phòng chống gian lận trên một thiết bị nhất định mà người dùng có thể cần
để liên kết việc sử dụng hoặc các hành động trên một nhóm ứng dụng do một tổ chức sở hữu.
Tóm tắt
Hằng số | |
---|---|
int |
SCOPE_APP
appSetId được dành cho một ứng dụng. |
int |
SCOPE_DEVELOPER
AppSetId được dùng cho một tài khoản nhà phát triển trên một cửa hàng ứng dụng. |
Hàm khởi tạo công khai | |
---|---|
AppSetId(String appSetId, int appSetIdScope)
Tạo một thực thể của |
Phương thức công khai | |
---|---|
boolean
|
equals(Object o)
Cho biết liệu một số đối tượng khác có "bằng" đối tượng này hay không. |
String
|
getId()
Truy xuất appSetId. |
int
|
getScope()
Truy xuất phạm vi của appSetId. |
int
|
hashCode()
Trả về một giá trị mã băm cho đối tượng. |
Các phương thức kế thừa | |
---|---|
Hằng số
ỨNG DỤNG PHẠM VI
public static final int SCOPE_APP
appSetId được dành cho một ứng dụng. Tất cả các ứng dụng trên một thiết bị sẽ có một appSetId khác.
Giá trị không đổi: 1 (0x00000001)
NHÀ PHÁT TRIỂN PHẠM VI
public static final int SCOPE_DEVELOPER
AppSetId được dùng cho một tài khoản nhà phát triển trên một cửa hàng ứng dụng. Tất cả ứng dụng từ cùng một nhà phát triển trên thiết bị sẽ có cùng appSetId trong phạm vi nhà phát triển.
Giá trị không đổi: 2 (0x00000002)
Hàm khởi tạo công khai
Mã nhóm ứng dụng
public AppSetId (String appSetId, int appSetIdScope)
Tạo một thực thể của AppSetId
Tham số | |
---|---|
appSetId |
String : do dịch vụ của nhà cung cấp tạo ra.
Giá trị này không được là null . |
appSetIdScope |
int : phạm vi của appSetId.
Giá trị là SCOPE_APP hoặc SCOPE_DEVELOPER |
Phương thức công khai
equals
public boolean equals (Object o)
Cho biết liệu một số đối tượng khác có "bằng" đối tượng này hay không.
Phương thức equals
triển khai mối quan hệ
tương đương trên các tệp tham chiếu đối tượng không có giá trị null:
- Phản hồi: đối với mọi giá trị tham chiếu không có giá trị null
x
,x.equals(x)
sẽ trả vềtrue
. - Đó là đối xứng: đối với mọi giá trị tham chiếu không có giá trị null
x
vày
,x.equals(y)
sẽ trả vềtrue
nếu và chỉ khiy.equals(x)
trả vềtrue
. - Giá trị này là tạm thời: đối với mọi giá trị tham chiếu không có giá trị null
x
,y
, vàz
, nếux.equals(y)
trả vềtrue
vày.equals(z)
trả vềtrue
, sau đóx.equals(z)
sẽ trả vềtrue
. - Giá trị này nhất quán: đối với mọi giá trị tham chiếu không có giá trị null
x
vày
, nhiều lệnh gọix.equals(y)
sẽ trả về một cách nhất quántrue
hoặc trả về nhất quánfalse
, miễn là không có thông tin nào được sử dụng trong thông tin so sánhequals
trên các đối tượng được sửa đổi. - Đối với mọi giá trị tham chiếu không có giá trị null
x
,x.equals(null)
sẽ trả vềfalse
.
Phương thức equals
cho loại Object
triển khai
mối quan hệ tương đương có thể phân biệt nhiều nhất trên các đối tượng;
tức là đối với mọi giá trị tham chiếu không có giá trị null x
và
y
, phương thức này trả về true
nếu và chỉ
khi x
và y
tham chiếu đến cùng một đối tượng
(x == y
có giá trị true
).
Xin lưu ý rằng thông thường, bạn cần phải ghi đè phương thức hashCode
bất cứ khi nào phương thức này bị ghi đè, để duy trì
hợp đồng chung cho phương thức hashCode
, trong đó nêu rõ
rằng các đối tượng bằng nhau phải có mã băm bằng nhau.
Tham số | |
---|---|
o |
Object : đối tượng tham chiếu cần so sánh. |
Giá trị trả về | |
---|---|
boolean |
true nếu đối tượng này giống với đối số obj; nếu không thì false . |
getId
public String getId ()
Truy xuất appSetId. API này luôn trả về một appSetId không trống.
Giá trị trả về | |
---|---|
String |
Giá trị này không được là null . |
getScope
public int getScope ()
Truy xuất phạm vi của appSetId.
Giá trị trả về | |
---|---|
int |
Giá trị là SCOPE_APP hoặc SCOPE_DEVELOPER |
hashCode
public int hashCode ()
Trả về một giá trị mã băm cho đối tượng. Phương thức này được
hỗ trợ vì lợi ích của bảng băm, chẳng hạn như các bảng do
HashMap
cung cấp.
Hợp đồng chung của hashCode
là:
- Bất cứ khi nào được gọi trên cùng một đối tượng nhiều lần trong quá trình
thực thi một ứng dụng Java, phương thức
hashCode
phải luôn trả về cùng một số nguyên, miễn là không sử dụng thông tin nào trongequals
các phép so sánh trên đối tượng được sửa đổi. Số nguyên này không nhất thiết phải từ một lần thực thi của một ứng dụng đến lần thực thi khác của cùng một ứng dụng. - Nếu có hai đối tượng bằng nhau theo phương thức
equals(Object)
, thì việc gọi phương thứchashCode
trên một trong hai đối tượng phải tạo ra một kết quả số nguyên. - Điều đó là không bắt buộc nếu phương thức
equals(java.lang.Object)
không giống nhau đối với hai đối tượng, khi đó phương thứchashCode
sẽ được gọi trên một trong hai đối tượng phải tạo ra kết quả số nguyên riêng biệt. Tuy nhiên, người lập trình cần lưu ý rằng việc tạo kết quả số nguyên riêng biệt cho các đối tượng không bằng nhau có thể cải thiện hiệu suất của bảng băm.
Thực tế, phương thức hashCode mà loại Object
xác định cũng trả về số nguyên riêng cho các đối tượng riêng biệt. (hashCode có thể được hoặc không được triển khai dưới dạng một hàm nào đó về địa chỉ bộ nhớ của đối tượng tại thời điểm cụ thể.)
Giá trị trả về | |
---|---|
int |
một giá trị mã băm cho đối tượng này. |