registerExtendedClient:client:

注册扩展客户端接口

registerExtendedClient:client: 用于在原生层和小游戏引擎之间建立自定义能力通道。通过该方法，您可以将原生端的业务对象（如内购组件、社交分享插件、或特定的硬件控制类）注入到小游戏运行环境中。小游戏脚本可以通过约定的 scope 命名空间直接调用该对象的方法。

---

方法声明

/**
 * 注册扩展客户端。
 * @param scope 命名空间字符串。小游戏通过该标识符访问对应的功能（如 "PayClient"）。
 * @param client 实现特定扩展协议的 NSObject 实例。
 */
- (void)registerExtendedClient:(NSString *)scope client:(NSObject *)client;

---

参数说明

参数名	类型	必传	描述
scope	NSString	是	唯一标识符：建议使用驼峰命名（如 LiveStream）。游戏端将通过此 key 获取接口。
client	NSObject	是	原生实例：通常需要实现 SDK 定义的扩展基类或协议，包含供游戏调用的方法。

---

运行行为

1. 注入映射：SDK 内部维护一个映射表。当 JavaScript 层尝试访问该 scope 时，指令会被路由到关联的 client 实例。
2. 方法转换：JavaScript 层的异步调用（Promise）会被转换为原生端的方法执行。
3. 生命周期绑定：注册的扩展客户端通常随 gameHandle 的销毁而解绑，确保内存安全。

---

代码示例

实现一个自定义的“震动反馈”扩展：

// 1. 定义扩展客户端类
@interface VibrationExtension : NSObject
- (void)vibrate:(NSDictionary *)params callback:(void(^)(NSDictionary *))callback;
@end

@implementation VibrationExtension
- (void)vibrate:(NSDictionary *)params callback:(void(^)(NSDictionary *))callback {
    UIImpactFeedbackGenerator *generator = [[UIImpactFeedbackGenerator alloc] initWithStyle:UIImpactFeedbackStyleHeavy];
    [generator impactOccurred];
    if (callback) callback(@{@"success": @YES});
}
@end

// 2. 注册到游戏实例
VibrationExtension *vibClient = [[VibrationExtension alloc] init];
[self.gameHandle registerExtendedClient:@"HapticEngine" client:vibClient];

// 3. 小游戏端调用示例 (JS)
// sudRuntime.getExtendedClient("HapticEngine").vibrate({ intensity: 1.0 });

---

注意事项

• 命名冲突：scope 必须全局唯一。如果重复注册相同的 scope，后注册的实例通常会覆盖前者。
• 线程安全：小游戏引擎的回调可能发生在子线程。如果 client 内部涉及 UI 操作（如弹出分享面板），务必手动切换到主线程执行。
• 协议匹配：client 实例中的方法名和参数格式必须与小游戏端的调用约定保持一致，否则会导致调用失败或崩溃。
• 注册时机：建议在调用 start: 之前完成注册，以确保游戏启动后的逻辑能够立即使用这些扩展能力。

---