Docs / SDK API Reference / Cocos Creator
Cocos Creator SDK API Reference
Complete Cocos Creator public surface generated from the public SDK interface definition: classes, interfaces, enums, events, error identifiers and capability scope.
Generated from the public SDK interface definitions
Version v1.1.0 · Updated 2026-10-26 · revision 1
Interface overview
This page lists the public API of Cocos Creator: classes, methods, overloads, properties, events and error codes. The interface definition matches the SDK package version.
Checklist item Count
Interface / class 2
Method 63
Method overloads 63
Property 0
Enums 5
error-code constants 4
Availability
This platform's SDK: Generally available . The interface definition matches the SDK package version; runtime capability follows the published SDK package.
Join channel flow
Arranged in the typical call order of join / leave / publish / subscribe; the parameter table is expanded under “Parameters of the minimal runnable flow”.
parameters for the minimal runnable flow
Parameters Type Optional Variadic parameters
enabledbooleanNo No
configstring|AgoraRtcEngineConfigNo No
tokenstringNo No
channelIdstringNo No
uidnumberNo No
optionsAgoraChannelMediaOptionsis No
optionsAgoraLeaveChannelOptionsis No
uidnumberNo No
mutedbooleanNo No
tokenstringNo No
profile'communication'|'liveBroadcasting'No No
role'broadcaster'|'audience'No No
optionsAgoraClientRoleOptionsis No
Endpoint index
all endpoints
AgoraRtc 1 method / 0 Property typescript Copy createAgoraRtcClient(options?: AgoraRtcClientOptions): AgoraRtcClient
Method detail: 1 / 1 (parameters, returns, errors)
Method Parameters Returns Errors
createAgoraRtcClientoptions?: AgoraRtcClientOptionsAgoraRtcClientError code index
AgoraRtcClient 62 method / 0 Property typescript Copy adjustAudioMixingPlayoutVolume(volume: number): Promise<void >
adjustAudioMixingPublishVolume(volume: number): Promise<void >
adjustAudioMixingVolume(volume: number): Promise<void >
adjustPlaybackSignalVolume(volume: number): Promise<void >
adjustUserPlaybackSignalVolume(uid: number, volume: number): Promise<void >
destroy(): Promise<void >
enableAudio(enabled: boolean): Promise<void >
enableAudioVolumeIndication(interval: number, smooth?: number, reportVad?: boolean): Promise<void >
enableContentInspect(enabled: boolean, config?: AgoraContentInspectConfig): Promise<void >
enableLocalAudio(enabled: boolean): Promise<void >
enableLocalVideo(enabled: boolean): Promise<void >
enableVideo(enabled: boolean): Promise<void >
getAudioMixingCurrentPosition(): Promise<number>
getErrorDescription(code: number): Promise<string>
getSdkVersion(): Promise<string>
initialize(config: string|AgoraRtcEngineConfig): Promise<void >
isSpeakerphoneEnabled(): Promise<boolean>
joinChannel(token: string, channelId: string, uid: number, options?: AgoraChannelMediaOptions): Promise<void >
leaveChannel(options?: AgoraLeaveChannelOptions): Promise<void >
muteAllRemoteAudioStreams(muted: boolean): Promise<void >
muteAllRemoteVideoStreams(muted: boolean): Promise<void >
muteLocalAudioStream(muted: boolean): Promise<void >
muteLocalVideoStream(muted: boolean): Promise<void >
muteRemoteAudioStream(uid: number, muted: boolean): Promise<void >
muteRemoteVideoStream(uid: number, muted: boolean): Promise<void >
off(eventName: K, listener: (payload:AgoraEventMap[K])=>void ): void
on(eventName: K, listener: (payload:AgoraEventMap[K])=>void ): ()=>void
pauseAudioMixing(): Promise<void >
pauseEffect(soundId: number): Promise<void >
playEffect(config: AgoraPlayEffectConfig): Promise<void >
preloadEffect(soundId: number, path: string, startPos?: number): Promise<void >
removeLocalVideoView(): Promise<void >
removeRemoteVideoView(uid: number): Promise<void >
renewToken(token: string): Promise<void >
resumeAudioMixing(): Promise<void >
resumeEffect(soundId: number): Promise<void >
setAudioMixingPosition(positionMs: number): Promise<void >
setAudioProfile(profile: AgoraAudioProfileValue, scenario?: AgoraAudioScenarioValue): Promise<void >
setAudioSessionOperationRestriction(restriction: number): Promise<void >
setBeautyEffectOptions(enabled: boolean, options: AgoraBeautyOptions, mediaSourceType?: AgoraMediaSourceTypeValue): Promise<void >
setChannelProfile(profile: 'communication' |'liveBroadcasting' ): Promise<void >
setClientRole(role: 'broadcaster' |'audience' , options?: AgoraClientRoleOptions): Promise<void >
setDefaultAudioRouteToSpeakerphone(enabled: boolean): Promise<void >
setEffectsVolume(volume: number): Promise<void >
setEnableSpeakerphone(enabled: boolean): Promise<void >
setLogFile(path: string): Promise<void >
setLogFilter(level: number): Promise<void >
setNativeVideoOverlaySuspended(suspended: boolean): Promise<void >
setParameters(parameters: string|Record<string,unknown>): Promise<void >
setRenderBackend(backend: AgoraRenderBackend): Promise<void >
setVideoEncoderConfiguration(config: AgoraVideoEncoderConfiguration): Promise<void >
setupLocalVideoView(canvas: AgoraRtcVideoCanvas): Promise<void >
setupRemoteVideoView(uid: number, canvas: AgoraRtcVideoCanvas): Promise<void >
startAudioMixing(config: AgoraAudioMixingConfig): Promise<void >
startPreview(videoSourceType?: AgoraVideoSourceTypeValue): Promise<void >
stopAudioMixing(): Promise<void >
stopEffect(soundId: number): Promise<void >
stopPreview(videoSourceType?: AgoraVideoSourceTypeValue): Promise<void >
switchCamera(): Promise<void >
updateLocalVideoView(canvas: AgoraRtcVideoCanvas): Promise<void >
updateRemoteVideoView(uid: number, canvas: AgoraRtcVideoCanvas): Promise<void >
uploadLogFile(): Promise<string>
Method detail: 62 / 62 (parameters, returns, errors)
Method Parameters Returns Errors
adjustAudioMixingPlayoutVolumevolume: numberPromise<void>Error code index
adjustAudioMixingPublishVolumevolume: numberPromise<void>Error code index
adjustAudioMixingVolumevolume: numberPromise<void>Error code index
adjustPlaybackSignalVolumevolume: numberPromise<void>Error code index
adjustUserPlaybackSignalVolumeuid: number, volume: numberPromise<void>Error code index
destroy— Promise<void>Error code index
enableAudioenabled: booleanPromise<void>Error code index
enableAudioVolumeIndicationinterval: number, smooth?: number, reportVad?: booleanPromise<void>Error code index
enableContentInspectenabled: boolean, config?: AgoraContentInspectConfigPromise<void>Error code index
enableLocalAudioenabled: booleanPromise<void>Error code index
enableLocalVideoenabled: booleanPromise<void>Error code index
enableVideoenabled: booleanPromise<void>Error code index
getAudioMixingCurrentPosition— Promise<number>Error code index
getErrorDescriptioncode: numberPromise<string>Error code index
getSdkVersion— Promise<string>Error code index
initializeconfig: string|AgoraRtcEngineConfigPromise<void>Error code index
isSpeakerphoneEnabled— Promise<boolean>Error code index
joinChanneltoken: string, channelId: string, uid: number, options?: AgoraChannelMediaOptionsPromise<void>Error code index
leaveChanneloptions?: AgoraLeaveChannelOptionsPromise<void>Error code index
muteAllRemoteAudioStreamsmuted: booleanPromise<void>Error code index
muteAllRemoteVideoStreamsmuted: booleanPromise<void>Error code index
muteLocalAudioStreammuted: booleanPromise<void>Error code index
muteLocalVideoStreammuted: booleanPromise<void>Error code index
muteRemoteAudioStreamuid: number, muted: booleanPromise<void>Error code index
muteRemoteVideoStreamuid: number, muted: booleanPromise<void>Error code index
offeventName: K, listener: (payload:AgoraEventMap[K])=>voidvoidError code index
oneventName: K, listener: (payload:AgoraEventMap[K])=>void()=>voidError code index
pauseAudioMixing— Promise<void>Error code index
pauseEffectsoundId: numberPromise<void>Error code index
playEffectconfig: AgoraPlayEffectConfigPromise<void>Error code index
preloadEffectsoundId: number, path: string, startPos?: numberPromise<void>Error code index
removeLocalVideoView— Promise<void>Error code index
removeRemoteVideoViewuid: numberPromise<void>Error code index
renewTokentoken: stringPromise<void>Error code index
resumeAudioMixing— Promise<void>Error code index
resumeEffectsoundId: numberPromise<void>Error code index
setAudioMixingPositionpositionMs: numberPromise<void>Error code index
setAudioProfileprofile: AgoraAudioProfileValue, scenario?: AgoraAudioScenarioValuePromise<void>Error code index
setAudioSessionOperationRestrictionrestriction: numberPromise<void>Error code index
setBeautyEffectOptionsenabled: boolean, options: AgoraBeautyOptions, mediaSourceType?: AgoraMediaSourceTypeValuePromise<void>Error code index
setChannelProfileprofile: 'communication'|'liveBroadcasting'Promise<void>Error code index
setClientRolerole: 'broadcaster'|'audience', options?: AgoraClientRoleOptionsPromise<void>Error code index
setDefaultAudioRouteToSpeakerphoneenabled: booleanPromise<void>Error code index
setEffectsVolumevolume: numberPromise<void>Error code index
setEnableSpeakerphoneenabled: booleanPromise<void>Error code index
setLogFilepath: stringPromise<void>Error code index
setLogFilterlevel: numberPromise<void>Error code index
setNativeVideoOverlaySuspendedsuspended: booleanPromise<void>Error code index
setParametersparameters: string|Record<string,unknown>Promise<void>Error code index
setRenderBackendbackend: AgoraRenderBackendPromise<void>Error code index
setVideoEncoderConfigurationconfig: AgoraVideoEncoderConfigurationPromise<void>Error code index
setupLocalVideoViewcanvas: AgoraRtcVideoCanvasPromise<void>Error code index
setupRemoteVideoViewuid: number, canvas: AgoraRtcVideoCanvasPromise<void>Error code index
startAudioMixingconfig: AgoraAudioMixingConfigPromise<void>Error code index
startPreviewvideoSourceType?: AgoraVideoSourceTypeValuePromise<void>Error code index
stopAudioMixing— Promise<void>Error code index
stopEffectsoundId: numberPromise<void>Error code index
stopPreviewvideoSourceType?: AgoraVideoSourceTypeValuePromise<void>Error code index
switchCamera— Promise<void>Error code index
updateLocalVideoViewcanvas: AgoraRtcVideoCanvasPromise<void>Error code index
updateRemoteVideoViewuid: number, canvas: AgoraRtcVideoCanvasPromise<void>Error code index
uploadLogFile— Promise<string>Error code index
event name callback parameters
audioMixingFinishedRecord<string,never>
audioMixingStateChanged{state:number;reason:number;}
connectionInterruptedRecord<string,never>
connectionStateChanged{state:number;reason:number;}
contentInspectResult{result:number;}
error{code?:number|string;message:string;}
firstLocalAudioFramePublished{elapsed:number;}
joinChannelSuccess{channelId:string;uid:number;elapsed:number;}
leaveChannelAgoraRtcStatsPayload
localVideoStateChanged{sourceType:number;state:number;error:number;}
localVideoTextureReady{slotId:number;width:number;height:number;}
localVideoTextureReleased{slotId:number;}
rejoinChannelSuccess{channelId:string;uid:number;elapsed:number;}
remoteAudioStateChanged{uid:number;state:number;reason:number;elapsed:number;}
remoteVideoStateChanged{uid:number;state:number;reason:number;elapsed:number;}
remoteVideoTextureReady{uid:number;slotId:number;width:number;height:number;}
remoteVideoTextureReleased{uid:number;slotId:number;}
renderBackendState{backend:string;phase:string;result:number;uid:number;fallbackBackend?:string;platform?:string;}
rtcStatsAgoraRtcStatsPayload
uploadLogResult{requestId:string;success:boolean;reason:number;}
userJoined{uid:number;elapsed:number;}
userOffline{uid:number;reason?:number;}
volumeIndication{speakers:Array<{uid:number;volume:number;vad:number;voicePitch:number;}>;totalVolume:number;}
Enums
AgoraAudioProfile 7 members Member value
Default0
SpeechStandard1
MusicStandard2
MusicStandardStereo3
MusicHighQuality4
MusicHighQualityStereo5
Iot6
AgoraAudioScenario 7 members Member value
Default0
GameStreaming3
Chatroom5
Chorus7
Meeting8
AiServer9
AiClient10
AgoraErrorCode 4 members Member value
BridgeUnavailablenull
Timeoutnull
NativeFailurenull
ProtocolErrornull
AgoraMediaSourceType 2 members Member value
PrimaryCamera2
SecondaryCamera3
AgoraVideoSourceType 5 members Member value
Camera0
CameraSecondary1
ScreenPrimary2
ScreenSecondary3
Transcoded10
error-code constants
Constant value
BridgeUnavailablenull
NativeFailurenull
ProtocolErrornull
Timeoutnull