TikTok for Developers

Developer Docs

Last updated August 4, 2026

Mini Games SDK Changelog

This changelog describes updates to the Mini Games SDK base library version and the corresponding TikTok app version.

SDK 0.35.0 / Client 46.3.0 (July 27, 2026)

What's new

  1. Added new API getUpdateManager, which supports listening to the version update status via onCheckForUpdate, onUpdateReady, and onUpdateFailed, and applying the ready new version via applyUpdate

Improvements

  1. Optimized the native image memory management when the skity is enabled in the Krypton rendering engine, and support automatic release of native image memory

SDK 0.34.0 / Client 46.2.0 (July 20, 2026)

Improvements

  1. Improved the monitoring for the call of critical APIs such as login, authorization, payment, sharing and advertisement, record the call results and time consumption, and enhance the capability of problem locating

Bug fixes

  1. Fixed the compatibility issue of Canvas using video and image sources in 2D and WebGL scenarios under the Krypton rendering engine

SDK 0.33.0 / Client 46.1.0 (July 13, 2026)

What's new

  1. Added preloading capabilities for incentive ads and interstitial ads: RewardedVideoAd, InterstitialAd support load, onLoad, offLoad

Improvements

  1. Optimized the domain name allowlist error prompts for request and downloadFile
  2. Improved the subpackage pre-download in debug mode and the interaction scenario data collection, support synchronizing pre-download collection and supplement diagnostic logs

Bug fixes

  1. Fixed the canIUse issue of inaccurate judgment on the capability path of returned objects for some APIs
  2. Fixed the issue where ad close and error events may trigger duplicate callbacks, and subErrorCode may be lost in some error scenarios subErrorCode

SDK 0.32.0 / Client 46.0.0 (July 6, 2026)

What's new

  1. Added new APIs getRevisitMissionReward, reportMissionRewardGranted, which are used to query the eligibility for revisit mission rewards and report the reward distribution results.

Bug fixes

  1. Fixed an issue where some asynchronous APIs might throw errors when the options parameter was not passed

SDK 0.31.0 / Client 45.9.0 (June 29, 2026)

What's new

  1. New API createUDPSocket, which supports UDP Socket binding, connection, data transmission, shutdown and event listening

Improvements

  1. Optimized subpackage pre-download and interaction scenario data collection in debug mode, supporting the sending of preDownloadSubpackage, reportScene information to developer tools

SDK 0.30.0 / Client 45.8.0 (June 22, 2026)

Improvements

  1. Restored the display governance for JS-side interstitial ads and rewarded ads, and added user interaction verification, startup phase restrictions, display frequency cap, and exception reporting

SDK 0.29.0 / Client 45.7.0 (June 15, 2026)

No changes

SDK 0.28.0 / Client 45.6.0 (June 8, 2026)

No changes

SDK 0.27.0 / Client 45.5.0 (June 1, 2026)

What's new

  1. Added new APIs showToast, hideToast, showLoading, hideLoading, which are used to display and dismiss message prompts and loading prompts
  2. Added new APIs restartMiniProgramSync, exitMiniProgram for restarting and exiting mini games
  3. Added new API triggerGC for actively triggering garbage collection

Improvements

  1. Optimized the display governance of interstitial ads and rewarded ads, and added user interaction verification, startup phase restrictions, display frequency cap and exception reporting

Bug fixes

  1. Fixed the issue where passing the encoding parameter to the file read/write interface in Buffer mode causes exceptions
  2. Fixed the compatibility issues of Unity Canvas video rendering and WebGL compressed textures in iOS high-performance mode

SDK 0.26.0 / Client 45.4.0 (May 25, 2026)

What's new

  1. Added new API reportScene to report custom scene data during the startup phase of a mini game
  2. Added new APIs onFeedStatusChange and offFeedStatusChange, which are used to listen for and cancel the listening of the entry and exit statuses of feed direct output mini games

Improvements

  1. Added setImmediate and clearImmediate compatibility implementations, with support for callback exception capturing and output

Bug fixes

  1. Fixed an issue where preload muting might fail in the direct output scenario of the Instant Game feed

SDK 0.25.0 / Client 45.3.0 (May 18, 2026)

Improvements

  1. Optimized audio processing for the Instant Game feed direct output scenario, and automatically mute the audio during game preloading

SDK 0.24.0 / Client 45.2.0 (May 11, 2026)

No changes

SDK 0.23.0 / Client 45.1.0 (April 30, 2026)

What's new

  1. Added new APIs createVideo, createOffscreenVideo for in-game video playback

Improvements

  1. Switched the 2D rendering engine to skity to improve text rendering quality and performance
  2. Android adds the definition and injection of window objects to improve the compatibility of the mini game operating environment

SDK 0.22.0 / Client 45.0.0 (April 23, 2026)

What's new

  1. Added new APIs onMemoryWarning and offMemoryWarning to listen for alarm events indicating insufficient device memory

SDK 0.21.0 / Client 44.9.0 (April 16, 2026)

What's new

  1. Added new API requestSubscribeMessage that opens the client-side message subscription interface for mini game subscription

Improvements

  1. Optimized the API path parsing issue related to files and normalized the path parameter

SDK 0.20.0 / Client 44.8.0 (April 8, 2026)

No changes

SDK 0.19.0 / Client 44.7.0 (March 26, 2026)

What's new

  1. Added new APIs related to screen brightness and always-on:
    1. setKeepScreenOn (Set the always-on state of the screen)
    2. getScreenBrightness (Get the current screen brightness)
    3. setScreenBrightness (Set the screen brightness)

SDK 0.18.0 / Client 44.6.0 (March 26, 2026)

  1. Added new APIsFileSystemManager.appendFile, FileSystemManager.appendFileSync to append content to the end of the file
  2. Added new APIssFileSystemManager.truncate, FileSystemManager.truncateSync to truncate a file to a specified length
  3. Added new APIsFileSystemManager.ftruncate, FileSystemManager.ftruncateSync to truncate an opened file to a specified length
  4. Added new APIsFileSystemManager.readCompressedFile,FileSystemManager.readCompressedFile to read compressed file
  5. Added new APIs FileSystemManager.readZipEntry to read file entries within a ZIP package
  6. Added new network status management series of APIs which support developers to perceive changes in the network environment and optimize the user experience in weak network scenarios:
    1. getNetworkType (Get the current network type)
    2. onNetworkWeakChange (Listen for changes in weak network status)
    3. offNetworkWeakChange (Cancel listening for weak network status)

SDK 0.17.0 / Client 44.5.0 (March 24, 2026)

No changes

SDK 0.16.0 / Client 44.4.0 (March 18, 2026)

What's new

  1. Added new APIsFileSystemManager.stat,FileSystemManager.statSync to get file status information
  2. Added new APIsFileSystemManager.fstat,FileSystemManager.fstatSync to get status information of an opened file
  3. Added new APIsFileSystemManager.rename, FileSystemManager.renameSync to rename files
  4. Added new APIs FileSystemManager.getFileInfo to get file information
  5. Added new APIsFileSystemManager.saveFile, FileSystemManager.saveFileSync to save files locally
  6. Added new APIsFileSystemManager.getSavedFileList to get the list of saved files
  7. Added new APIsFileSystemManager.removeSavedFile to delete saved files

SDK 0.15.0 / Client 44.3.0 (March 11, 2026)

What's new

  1. Added new APIsFileSystemManager.open,FileSystemManager.openSync - Open File
  2. Added new APIsFileSystemManager.close,FileSystemManager.closeSync - Close File
  3. Added new APIsFileSystemManager.read,FileSystemManager.readSync - Read File
  4. Added new APIsFileSystemManager.write, FileSystemManager.writeSync - Write to File
  5. Added new APIsFileSystemManager.rmdir, FileSystemManager.rmdirSync - Remove Directory
  6. Added new APIsFileSystemManager.readdir, FileSystemManager.readdirSync - Read Directory
  7. Added new APIsFileSystemManager.unlink, FileSystemManager.unlinkSync - Delete File

SDK 0.14.0 / Client 44.2.0 (March 4, 2026)

No changes

SDK 0.13.0 / Client 44.1.0 (February 24, 2026)

No changes

SDK 0.12.0 / Client 44.0.0 (February 24, 2026)

No changes

SDK 0.11.0 / Client 43.9.0 (February 24, 2026)

Bug fixes

  1. Fixed the issue where downloading fails due to spaces in the URL of TTMinis.game.downloadFile

SDK 0.10.0 / Client 43.8.0 (January 27, 2026)

What's new

  1. Added APIs TTMinis.game.vibrateLong and TTMinis.game.vibrateShort, which can make the phone vibrate

SDK 0.9.0 / Client 43.7.0 (January 22, 2026)

Improvements

  1. Updated the error code fields for interstitial ads and rewarded ads, renaming errorMsg to errMsg to align with the rest of the API

Bug fixes

  1. Fixed an issue where TTMinis.game.getStorageSync and TTMinis.game.setStorageSync could throw exceptions when a non-string key was passed

SDK 0.8.0 / Client 42.6.0 (January 19, 2026)

What's new

  1. Added API TTMinis.game.getStorageInfoTTMinis.game.getStorageInfoSync to get the storage info

Improvements

  1. Updated API TTMinis.game.login error codes to pass through client and server error codes

Bug fixes

  1. Fixed an issue where passing both defaultValue and maxLength to the API TTMinis.game.showKeyboard on Android caused an error

SDK 0.7.0 / Client 43.5.0 (January 15, 2026)

No changes

SDK 0.6.0 / Version 43.4.0 (December 30, 2025)

What's new

  1. Added support for loading Wasm files using TTWebAssembly
  2. Added API TTMinis.game.showKeyboard, TTMinis.game.hideKeyboard to use keyboard-related features
  3. Added API TTMinis.game.setPreferredFramesPerSecond to modify rendering frame rate

SDK 0.5.0 / Version 43.1.0 (December 19, 2025)

What's new

  1. Added support for game engine plugins

Bug fixes

  1. Fixed API fileSystem.writeFile to support writing ArrayBuffer type

SDK 0.4.0 / Version 43.0.0 (December 4, 2025)

What's new

  1. Added API TTMinis.game.connectSocket to create a websocket connection
  2. Added API TTMinis.game.reportEvent for event reporting capability

SDK 0.3.0 / Version 42.9.0 (November 27, 2025)

What's new

  1. Added API TTMinis.game.getMenuButtonBoundingClientRect to get the layout position information of the menu button (top-right capsule button)
  2. Added API fileSystemManager.unzip to decompress files
  3. Added API TTMinis.game.createInterstitialAd to create an interstitial ad component

Improvements

  1. Updated API TTMinis.game.shareAppMessage to support query and path parameters

SDK 0.2.0 / Version 42.8.0 (November 20, 2025)

What's new

  1. Added API TTMinis.game.getWindowInfo to get window information

Improvements

  1. Updated API TTMinis.game.request to support passing the arraybuffer type as a parameter
  2. Updated APIs TTMinis.game.getSystemInfo and TTMinis.game.getSystemInfoSync to support fetching the statusBarHeight and safeArea fields

SDK 0.1.0 / Version 42.7.0 (November 18, 2025)

Bug fixes

  1. Fixed vConsole format logic to prevent JS OOM (Out Of Memory)
  2. Fixed API TTMinis.game.request issue where the default content-type was not application/json


TikTok for Developers