如何阅读Apple开发人员文档

Question

我对如何阅读Apple Developer文档感到非常困惑。它限制了我更深入地学习iOS编码环境，而不是YouTuber所教给我的。一个例子是这个

声明：

func run(_ configuration: ARConfiguration, 
 options: ARSession.RunOptions = [])

来自此Apple链接https://developer.apple.com/documentation/arkit/arsession/2875735-run

它想让我开始如何开始 arkit ，但我无法理解它想要我做什么。

• 那是什么代码？

• 我如何使用那条代码？

我根本不明白。我找不到任何解释Apple文档的教程。有人请向我解释一下，我需要知道这个

Answer 1

声明示例仅显示该方法的参数(其类型(。宣告声明，可以更详细地解释该方法可以在哪里使用。您询问了声明的目的；在该方法的名称(第一行(之后，它写成

开始使用指定的配置和选项为会话处理AR处理。

所以，这部分回答了您的第一个问题。方法声明的示例发生了什么，回答了您的第二个问题。

始终尝试阅读文档的Discussion部分，不要错过它。它将帮助您有一个基本的想法，方法，属性等在做什么。

但是，在某些情况下，几乎没有提供信息，除了声明。但是这些情况很少见。

Answer 2

代码行适用于文档中提到的以下内容：

开始使用指定的配置和选项为会话处理AR处理。

要回答您如何在上下文中使用该问题的问题，我们可以查看文章的概述。

用ARKIT构建的每种AR体验都需要一个单个武器对象。如果您使用ARSCNVIEW或ARSKVIEW对象轻松构建AR体验的视觉部分，则视图对象包含一个文献实例。如果您为AR内容构建自己的渲染器，则需要自己实例化和维护一个文献。

如果我们使用第一个建议，我们可以做以下建议。

// Create an instance of ARSKView
let view = ARSKView()
// We can get the session from the view as per documentation: 
// A view creates its own session object; use this property 
// to access and configure the view's session.
let session = view.session
// We now need to create an instance of a ARConfiguration subclass.
// Looking at the documentation we have the possibility of 
// ARWorldTrackingConfiguration, AROrientationTrackingConfiguration 
// or ARFaceTrackingConfiguration. 
let configuration = ARWorldTrackingConfiguration()
// We can now call our function because we have all that's necessary.
// You'll notice we're not passing a value for the second parameter because it has a default parameter of an empty array.
session.run(configuration)

为了提高您理解文档的能力，我建议您确定您没有足够的信息来实施的那一刻。在这种情况下，您要调用该功能 func run(_ configuration: ARConfiguration, options: ARSession.RunOptions = [])。请注意，该功能是在ARSession类型的接收器上调用的，并且需要传递ARConfiguration。您的下一步是研究这些类功能并在其中使用它们。