更新指南

本指南介绍了从一个Tapjoy SDK版本更新到另一个版本时所需的步骤，建议您执行所有步骤以防止出现任何问题或冲突。

14.2.0

• 请删除已弃用的TJPlacementListener onClick方法。它将在下一个主要版本中被删除，并且不再执行任何操作。
• 请删除已弃用的getSupportUrl方法。它将在下一个主要版本中被删除，并且不再执行任何操作。

Manual Integration

如果您手动集成，则有两项新activity需要添加到清单中。这些activity与预测性返回手势有关。

<activity
    android:name="com.tapjoy.TJAdUnitActivity"
    android:enableOnBackInvokedCallback="false"
    android:configChanges="orientation|keyboardHidden|screenSize"
    android:theme="@style/TranslucentTheme"
    android:hardwareAccelerated="true"
    tools:ignore="UnusedAttribute" />
<activity
    android:name="com.tapjoy.TJWebViewActivity"
    android:enableOnBackInvokedCallback="false"
    android:configChanges="orientation|keyboardHidden|screenSize"
    android:theme="@style/TranslucentTheme"
    android:hardwareAccelerated="true"
    tools:ignore="UnusedAttribute" />

14.0.0

• 请删除对 Tapjoy.setActivity() 的任何使用。它将在下一个主要版本中被删除，并且不再执行任何操作。
• 请删除对 Tapjoy.setGLSurfaceView() 的任何使用。它将在下一个主要版本中被删除，并且不再执行任何操作。
• 请将已弃用的方法 Tapjoy.trackPurchase() 替换为 trackPurchase(String currencyCode, double price)。

13.4.0

Tapjoy SDK增加了connectWarning回调。当连接期间出现非阻塞问题时，此回调将触发，connectSuccess也会在之后触发。 目前，此功能仅检测在ConnectFlags中设置UserId的问题。

Tapjoy.connect(getContext().getApplicationContext(), "SDK_KEY_GOES_HERE", connectFlags, new TJConnectListener() {
    @Override
    public void onConnectSuccess() {
        
    }
    @Override
    public void onConnectWarning(int code, String message) {
        
    }
    @Override
    public void onConnectFailure(int code, String message) {
        
    }    
}); 

13.2.0

Connect

我们在connectFailure回调中添加错误代码和相关信息。原有回调方法已经被弃用，但是仍然起作用。

Tapjoy.connect(getContext().getApplicationContext(), "SDK_KEY_GOES_HERE", connectFlags, new TJConnectListener() {
    @Override
    public void onConnectSuccess() {
        super.onConnectSuccess();
    }    
    @Override
    public void onConnectFailure(int code, String message) {
        super.onConnectFailure(code, message);
    }    
    @Override
    public void onConnectFailure() { //Deprecated
        super.onConnectFailure();
    }
}); 

Max User Level

您可以设置应用中的级别数目。在connect之前或之后都可以调用。

Tapjoy.setMaxLevel(10); 

User Segment

您可以在应用中设置用户的类型。在connect之前或之后都可以调用，在session中也可以调用。

Tapjoy.setUserSegment(TJSegment.VIP);
Tapjoy.setUserSegment(TJSegment.PAYER);
Tapjoy.setUserSegment(TJSegment.NON_PAYER);
Tapjoy.setUserSegment(TJSegment.UNKNOWN); 

Entry Point

在调用_request connect_之前，您可以设置进入点。这个进入点表示广告展示位置在您应用中的位置。您可以从下面的预设值中选择。

TJPlacement placement = Tapjoy.getPlacement("myPlacement", null);
placement.setEntryPoint(TJEntryPoint.ENTRY_POINT_MAIN_MENU);
placement.requestContent(); 

// Available values
TJEntryPoint.ENTRY_POINT_UNKNOWN
TJEntryPoint.ENTRY_POINT_OTHER
TJEntryPoint.ENTRY_POINT_MAIN_MENU
TJEntryPoint.ENTRY_POINT_HUD
TJEntryPoint.ENTRY_POINT_EXIT
TJEntryPoint.ENTRY_POINT_FAIL
TJEntryPoint.ENTRY_POINT_COMPLETE
TJEntryPoint.ENTRY_POINT_INBOX
TJEntryPoint.ENTRY_POINT_INIT
TJEntryPoint.ENTRY_POINT_STORE 

Currency

• Get/spend/earn不再支持负数。
• 如果您使用的自管理虚拟货币，当您调用Tapjoy管理虚拟货币API时返回错误。

您可以在创建展示位置之前设置用户账号余额。必须要在_requestContent_之前设置。

TJPlacement placement = Tapjoy.getPlacement("placement", this);
placement.setCurrencyBalance("1234", 100, new TJSetCurrencyBalanceListener() {
    @Override
    public void onSetCurrencyBalanceSuccess() {
        
    }

    @Override
    public void onSetCurrencyBalanceFailure(int code, String error) {

    }
}); 

您也可以设置用户在每个展示位置中达到目标需要获得的虚拟货币数量。

TJPlacement placement = Tapjoy.getPlacement("placement", this);
placement.setCurrencyAmountRequired("1234", 100, new TJSetCurrencyAmountRequiredListener() {
    @Override
    public void onSetCurrencyAmountRequiredSuccess() {
        
    }

    @Override
    public void onSetCurrencyAmountRequiredFailure(int code, String error) {

    }
});

12.8.0

Tapjoy现在使用我们自己的Maven存储库。 Bintray会在短期内继续工作，未来我们将停止使用，我们建议您尽快更新以使用我们的存储库。

所有以前的版本和新版本都可以通过我们的资源库获得，而Bintray上仅会提供12.8.0之前的版本。

您可以如下配置使用新资源库：

    repositories {
      maven {
        name "Tapjoy's maven repo"
        url "https://sdk.tapjoy.com/"
      }
    }

    dependencies {
      api 'com.tapjoy:tapjoy-android-sdk:12.8.0@aar'
    }