Allows some customization of sdk behavior.
延伸: | Object |
套件: | facebook |
Settings()
public Settings()
getLoggingBehaviors()
Certain logging behaviors are available for debugging beyond those that should be enabled in production.
Returns the types of extended logging that are currently enabled.
public static final Set getLoggingBehaviors()
addLoggingBehavior(LoggingBehavior)
Certain logging behaviors are available for debugging beyond those that should be enabled in production.
Enables a particular extended logging in the sdk.
public static final void addLoggingBehavior(LoggingBehavior behavior)
參數 | 說明 |
---|---|
behavior | The LoggingBehavior to enable |
removeLoggingBehavior(LoggingBehavior)
Certain logging behaviors are available for debugging beyond those that should be enabled in production.
Disables a particular extended logging behavior in the sdk.
public static final void removeLoggingBehavior(LoggingBehavior behavior)
參數 | 說明 |
---|---|
behavior | The LoggingBehavior to disable |
clearLoggingBehaviors()
Certain logging behaviors are available for debugging beyond those that should be enabled in production.
Disables all extended logging behaviors.
public static final void clearLoggingBehaviors()
isLoggingBehaviorEnabled(LoggingBehavior)
Certain logging behaviors are available for debugging beyond those that should be enabled in production.
Checks if a particular extended logging behavior is enabled.
public static final boolean isLoggingBehaviorEnabled(LoggingBehavior behavior)
參數 | 說明 |
---|---|
behavior | The LoggingBehavior to check |
getExecutor()
Returns the Executor used by the SDK for non-AsyncTask background work.
By default this uses AsyncTask Executor via reflection if the API level is high enough. Otherwise this creates a new Executor with defaults similar to those used in AsyncTask.
public static Executor getExecutor()
setExecutor(Executor)
Sets the Executor used by the SDK for non-AsyncTask background work.
public static void setExecutor(Executor executor)
參數 | 說明 |
---|---|
executor | The Executor to use; must not be null. |
getFacebookDomain()
Gets the base Facebook domain to use when making Web requests; in production code this will always be "facebook.com".
public static String getFacebookDomain()
setFacebookDomain(String)
Sets the base Facebook domain to use when making Web requests. This defaults to "facebook.com", but may be overridden to, e.g., "beta.facebook.com" to direct requests at a different domain. This method should never be called from production code.
public static void setFacebookDomain(String facebookDomain)
參數 | 說明 |
---|---|
facebookDomain | The base domain to use instead of "facebook.com" |
publishInstallAsync(Context, String)
Manually publish install attribution to the Facebook graph. Internally handles tracking repeat calls to prevent multiple installs being published to the graph.
public static void publishInstallAsync(Context context, String applicationId)
參數 | 說明 |
---|---|
context | The current Context |
applicationId | The fb application being published. This method is deprecated. See AppEventsLogger.activateApp(Context, String) for more info. |
publishInstallAsync(Context, String, Callback)
Manually publish install attribution to the Facebook graph. Internally handles tracking repeat calls to prevent multiple installs being published to the graph.
public static void publishInstallAsync(Context context, String applicationId, Callback callback)
參數 | 說明 |
---|---|
context | The current Context |
applicationId | The fb application being published. |
callback | A callback to invoke with a Response object, carrying the server response, or an error. This method is deprecated. See AppEventsLogger.activateApp(Context, String) for more info. |
setShouldAutoPublishInstall(boolean)
Sets whether opening a Session should automatically publish install attribution to the Facebook graph.
public static void setShouldAutoPublishInstall(boolean shouldAutoPublishInstall)
參數 | 說明 |
---|---|
shouldAutoPublishInstall | True to automatically publish, false to not This method is deprecated. See AppEventsLogger.activateApp(Context, String) for more info. |
getShouldAutoPublishInstall()
Gets whether opening a Session should automatically publish install attribution to the Facebook graph.
public static boolean getShouldAutoPublishInstall()
publishInstallAndWait(Context, String)
Manually publish install attribution to the Facebook graph. Internally handles tracking repeat calls to prevent multiple installs being published to the graph.
public static boolean publishInstallAndWait(Context context, String applicationId)
參數 | 說明 |
---|---|
context | The current Context |
applicationId | The fb application being published. |
publishInstallAndWaitForResponse(Context, String)
Manually publish install attribution to the Facebook graph. Internally handles caching repeat calls to prevent multiple installs being published to the graph.
public static Response publishInstallAndWaitForResponse(Context context, String applicationId)
參數 | 說明 |
---|---|
context | The current Context |
applicationId | The fb application being published. |
getAttributionId(ContentResolver)
Acquire the current attribution id from the facebook app.
public static String getAttributionId(ContentResolver contentResolver)
參數 | 說明 |
---|---|
contentResolver |
getAppVersion()
Gets the application version to the provided string.
public static String getAppVersion()
setAppVersion(String)
Sets the application version to the provided string. AppEventsLogger.logEvent calls logs its event with the current app version, and App Insights allows breakdown of events by app version.
public static void setAppVersion(String appVersion)
參數 | 說明 |
---|---|
appVersion | The version identifier of the Android app that events are being logged through. Enables analysis and breakdown of logged events by app version. |
getSdkVersion()
Gets the current version of the Facebook SDK for Android as a string.
public static String getSdkVersion()
getMigrationBundle()
Gets the current Facebook migration bundle string; this string can be passed to Graph API endpoints to specify a set of platform migrations that are explicitly turned on or off for that call, in order to ensure compatibility between a given version of the SDK and the Graph API.
public static String getMigrationBundle()
getLimitEventAndDataUsage(Context)
Gets whether data such as that generated through AppEventsLogger and sent to Facebook should be restricted from being used for purposes other than analytics and conversions, such as for targeting ads to this user. Defaults to false. This value is stored on the device and persists across app launches.
public static boolean getLimitEventAndDataUsage(Context context)
參數 | 說明 |
---|---|
context | Used to read the value. |
setLimitEventAndDataUsage(Context, boolean)
Sets whether data such as that generated through AppEventsLogger and sent to Facebook should be restricted from being used for purposes other than analytics and conversions, such as for targeting ads to this user. Defaults to false. This value is stored on the device and persists across app launches. Changes to this setting will apply to app events currently queued to be flushed.
public static void setLimitEventAndDataUsage(Context context, boolean limitEventUsage)
參數 | 說明 |
---|---|
context | Used to persist this value across app runs. |
limitEventUsage |
getOnProgressThreshold()
Gets the threshold used to report progress on requests.
public static long getOnProgressThreshold()
setOnProgressThreshold(long)
Sets the threshold used to report progress on requests. Note that the value will be read when the request is started and can not be changed during a request (or batch) execution.
public static void setOnProgressThreshold(long threshold)
參數 | 說明 |
---|---|
threshold | The number of bytes progressed to force a callback. |