如何将 TVML/JavaScriptCore 连接到 UIKit/Objective-C (Swift)？

Question

到目前为止tvOS 支持两种制作电视应用程序的方法，TVML 和 UIKit，并且没有官方提到如何将东西混合以制作 TVML（基本上是 XML）用户界面与本机对应部分应用逻辑和 I/O（如播放、流式传输、iCloud 持久性等）。

那么，在新的tvOS 应用中混合TVML 和UIKit 的最佳解决方案是什么？

在下文中，我尝试了一个解决方案，该解决方案遵循从 Apple 论坛改编的代码 sn-ps 以及有关 JavaScriptCore 到 ObjC/Swift 绑定的相关问题。 这是 Swift 项目中的一个简单包装类。

import UIKit
import TVMLKit
@objc protocol MyJSClass : JSExport {
    func getItem(key:String) -> String?
    func setItem(key:String, data:String)
}
class MyClass: NSObject, MyJSClass {
    func getItem(key: String) -> String? {
        return "String value"
    }

    func setItem(key: String, data: String) {
        print("Set key:\(key) value:\(data)")
    }
}

委托必须符合TVApplicationControllerDelegate:

typealias TVApplicationDelegate = AppDelegate
extension TVApplicationDelegate : TVApplicationControllerDelegate {

    func appController(appController: TVApplicationController, evaluateAppJavaScriptInContext jsContext: JSContext) {
        let myClass: MyClass = MyClass();
        jsContext.setObject(myClass, forKeyedSubscript: "objectwrapper");
    }

    func appController(appController: TVApplicationController, didFailWithError error: NSError) {
        let title = "Error Launching Application"
        let message = error.localizedDescription
        let alertController = UIAlertController(title: title, message: message, preferredStyle:.Alert ) self.appController?.navigationController.presentViewController(alertController, animated: true, completion: { () -> Void in
            })
        }

    func appController(appController: TVApplicationController, didStopWithOptions options: [String : AnyObject]?) {
    }

    func appController(appController: TVApplicationController, didFinishLaunchingWithOptions options: [String : AnyObject]?) {
    }
}

此时的javascript很简单就好了。看一下带有命名参数的方法，你需要更改 javascript 计数器部分方法名称：

   App.onLaunch = function(options) {
       var text = objectwrapper.getItem()
        // keep an eye here, the method name it changes when you have named parameters, you need camel case for parameters:      
       objectwrapper.setItemData("test", "value")
 }

App. onExit = function() {
        console.log('App finished');
    }

现在，假设你有一个非常复杂的 js 接口来导出

@protocol MXMJSProtocol<JSExport>
- (void)boot:(JSValue *)status network:(JSValue*)network user:(JSValue*)c3;
- (NSString*)getVersion;
@end
@interface MXMJSObject : NSObject<MXMJSProtocol>
@end
@implementation MXMJSObject
- (NSString*)getVersion {
  return @"0.0.1";
}

你可以这样做

JSExportAs(boot, 
      - (void)boot:(JSValue *)status network:(JSValue*)network user:(JSValue*)c3 );

此时在JS Counter部分你不会做驼峰式的：

objectwrapper.bootNetworkUser(statusChanged,networkChanged,userChanged)

但你会这样做：

objectwrapper.boot(statusChanged,networkChanged,userChanged)

最后再看这个界面：

- (void)boot:(JSValue *)status network:(JSValue*)network user:(JSValue*)c3;

传入的值 JSValue* 是在 ObjC/Swift 和 JavaScriptCore 之间传递完成处理程序的一种方式。此时在本机代码中，您将使用参数进行所有调用：

dispatch_async(dispatch_get_main_queue(), ^{
                                           NSNumber *state  = [NSNumber numberWithInteger:status];
                                           [networkChanged.context[@"setTimeout"]
                                            callWithArguments:@[networkChanged, @0, state]];
                                       });

在我的发现中，我发现如果您不在主线程和异步上调度，MainThread 将挂起。所以我将调用调用完成处理程序回调的javascript“setTimeout”调用。

所以我在这里使用的方法是：

• 使用JSExportAs 获取带有命名参数的方法，并避免使用驼峰式javascript 对应物，例如callMyParam1Param2Param3
• 使用JSValue 作为参数来摆脱完成处理程序。在本机端使用 callWithArguments。在JS端使用javascript函数；
• dispatch_async 用于完成处理程序，可能在 JavaScript 端调用 setTimeout 0-delayed，以避免 UI 冻结。

[更新] 为了更清楚，我已经更新了这个问题。我正在寻找一种桥接TVML 和UIKit 的技术解决方案，以便

• 通过JavaScriptCode了解最佳编程模型
• 拥有从JavaScriptCore 到ObjectiveC 和 反之亦然
• 从Objective-C 调用JavaScriptCode 时表现最佳

Answer 1

这个WWDC Video 解释了如何在 JavaScript 和 Obj-C 之间进行通信

这是我从 Swift 到 JavaScript 的通信方式：

//when pushAlertInJS() is called, pushAlert(title, description) will be called in JavaScript.
func pushAlertInJS(){
    
    //allows us to access the javascript context
    appController!.evaluateInJavaScriptContext({(evaluation: JSContext) -> Void in
        
        //get a handle on the "pushAlert" method that you've implemented in JavaScript
        let pushAlert = evaluation.objectForKeyedSubscript("pushAlert")
        
        //Call your JavaScript method with an array of arguments
        pushAlert.callWithArguments(["Login Failed", "Incorrect Username or Password"])
        
        }, completion: {(Bool) -> Void in
        //evaluation block finished running
    })
}

这是我从 JavaScript 到 Swift 的通信方式（它需要在 Swift 中进行一些设置）：

//call this method once after setting up your appController.
func createSwiftPrint(){

//allows us to access the javascript context
appController?.evaluateInJavaScriptContext({(evaluation: JSContext) -> Void in

    //this is the block that will be called when javascript calls swiftPrint(str)
    let swiftPrintBlock : @convention(block) (String) -> Void = {
        (str : String) -> Void in

        //prints the string passed in from javascript
        print(str)
    }

    //this creates a function in the javascript context called "swiftPrint". 
    //calling swiftPrint(str) in javascript will call the block we created above.
    evaluation.setObject(unsafeBitCast(swiftPrintBlock, AnyObject.self), forKeyedSubscript: "swiftPrint" as (NSCopying & NSObjectProtocol)?)
    }, completion: {(Bool) -> Void in
    //evaluation block finished running
})
}

[UPDATE] 对于那些想知道“pushAlert”在 javascript 端是什么样子的人，我将分享一个在 application.js 中实现的示例

var pushAlert = function(title, description){
   var alert = createAlert(title, description);
   alert.addEventListener("select", Presenter.load.bind(Presenter));
   navigationDocument.pushDocument(alert);
}


// This convenience funnction returns an alert template, which can be used to present errors to the user.

var createAlert = function(title, description) {  

   var alertString = `<?xml version="1.0" encoding="UTF-8" ?>
       <document>
         <alertTemplate>
           <title>${title}</title>
           <description>${description}</description>

         </alertTemplate>
       </document>`

   var parser = new DOMParser();

   var alertDoc = parser.parseFromString(alertString, "application/xml");

   return alertDoc
}

Answer 2

你激发了一个可行的想法......几乎。一旦显示了原生视图，目前还没有直接的方法可以将基于 TVML 的视图推送到导航堆栈上。我此时所做的是：

let appDelegate = UIApplication.sharedApplication().delegate as! AppDelegate
appDelegate.appController?.navigationController.popViewControllerAnimated(true)
dispatch_async(dispatch_get_main_queue()) {
    tvmlContext!.evaluateScript("showTVMLView()")
}

...然后在 JavaScript 方面：

function showTVMLView() {setTimeout(function(){_showTVMLView();}, 100);}
function _showTVMLView() {//push the next document onto the stack}

这似乎是将执行从主线程转移到 JSVirtualMachine 线程并避免 UI 锁定的最干净的方法。请注意，我至少必须弹出当前的原生视图控制器，否则它会收到一个致命的选择器。