A Simpler Way to Call Objective-C Methods with JavaScript (Experimental)

Prior to v3.4.0, the reflection mechanism in static methods, not only needed to strictly declare package names and function signatures, but also needed to strictly check the number of parameters to ensure proper operation, which was a complicated step.

Additionally provided in v3.4.0 is another experimental method for simplifying calls from the scripting layer to the native layer. This is a kind of channel, or a bridge, named JsbBridge before introducing other scripting systems, meaning that it serves as a bridge to communicate between script and native APP via the JSB binding.

Note: both ways are working fine, developers can choose to use them according to their actual needs. To use the previous way, please review the Using JavaScript to Call Objective-C documentation.

The only two interfaces at the scripting level are sendToNative and onNative, which are transfer and receive native layer parameters, respectively. The following points need to be noted when using them:

• This feature is still in the experimental stage, only string transfers are supported. To transfer objects containing multiple parameters, please consider converting them to the JSON format for transfer and parsing them at different levels.
• onNative will only record one function at a time, and will override the original onNative method when the property is set again.

• sendToScript corresponds to sendToNative and represents the parameters to be transferred to JavaScript.
• onScript corresponds to onNative, which indicates the response behavior after receiving a script message. Wrap the behavior by creating an interface called ICallback and use setCallback to enable the interface function.

//Objective-c
typedef void (^ICallback)(NSString*, NSString*);
@interface JsbBridge : NSObject
+(instancetype)sharedInstance;
-(bool)setCallback:(ICallback)cb;
-(void)sendToScript:(NSString*)arg0;
@end

Assuming the ad interface is set in the native layer, then when the player clicks the button to open the ad, it is logical to trigger ObjC to open the ad.

The code example of the interface to open the ad is as follows:

At this point, register the event that opens the ad first:

JsbBridge* m = [JsbBridge sharedInstance];
[m setCallback:cb];

Perform the open action on the button’s click event in the JavaScript layer script:

Using Objective-C to trigger JavaScript Callbacks

Assume that the animation playback operation is recorded in JavaScript. To play this animation in the Objective-C layer, register an event to play the animation.

First, define a function to play the animation:

public void playAnimation(animationName: string, isLoop: boolean){
    // Code to play Animation
}

Next, document the method in onNative:

The ObjC code example is as follows:

Creator provides the example, which developers can download for reference use as needed.