摘要：有提供類似的功能，但這并不包含在里頭。條列清單或是切換視圖是非常容易的，你主要是要建立一個使用者介面讓使用者去選取他們想觀看的內容。我使用了來確保當前載入模型占用的內存可以都被釋出。

此篇文章原作是 Autodesk ADN Philippe Leefsma，以下以我簡稱。

這有一個簡易的博客用來說明一個我剛加入 https://forge-rcdb.autodesk.io 的一個新功能，他主要是提供一個使用介面讓使用者可以在一個文檔（Forge Document）里不同的視圖（Forge Viewable）間快速的切換。A360 viewer有提供類似的功能，但這并不包含在 Forge Viewer 里頭。

在 Forge Document 里。條列 Viewable 清單或是切換視圖是非常容易的，你主要是要建立一個使用者介面讓使用者去選取他們想觀看的內容。如果您不知道要怎么讓 Forge Model Derivative 服務幫您轉換多個視圖，請先看看這篇文章：為什么Revit模型有多個視圖，丟到 Forge 轉換后確只剩一個? (如何設定多個視圖)

接著讓我們來看看該怎么實作這個功能（我所有的代碼都有用到 ES6、async/await，UI的部份使用了 React）：

一、從已轉換好的 URN 載入 Document：

/////////////////////////////////////////////////////////
// Load a document from URN
//
/////////////////////////////////////////////////////////
static loadDocument (urn) {

  return new Promise((resolve, reject) => {

    const paramUrn = !urn.startsWith("urn:")
      ? "urn:" + urn
      : urn

    Autodesk.Viewing.Document.load(paramUrn, (doc) => {

      resolve (doc)

    }, (error) => {

      reject (error)
    })
  })
}

二、從已載入的 Document 物件獲取所有 Viewable 清單：

/////////////////////////////////////////////////////////
// Return viewables
//
/////////////////////////////////////////////////////////
static getViewableItems (doc, roles = ["3d", "2d"]) {

  const rootItem = doc.getRootItem()

  let items = []

  const roleArray = roles
    ? (Array.isArray(roles) ? roles : [roles])
    : []

  roleArray.forEach((role) => {

    items = [ ...items,
      ...Autodesk.Viewing.Document.getSubItemsWithProperties(
        rootItem, { type: "geometry", role }, true) ]
  })

  return items
}

三、載入已選中的 Viewable：
首先，我門要把已載入的模型先卸載，下面的樣例是假設我們已經載入了一個模型，現在使用者選擇了新的 Viewable
要 Forge Viewer 載入。我使用了 viewer.tearDown() 來確保當前載入模型占用的內存可以都被釋出。這個樣例也支持從 3D 模型切換到 2D 模型，或者是反過來；您可以忽略我代碼里使用到的 React 相關的代碼。

/////////////////////////////////////////////////////////
// Load the selected viewable
//
/////////////////////////////////////////////////////////
onItemSelected (item) {

  const {activeItem} = this.react.getState()

  if (item.guid !== activeItem.guid) {

    this.viewer.tearDown()

    this.viewer.start()

    const path =
      this.viewerDocument.getViewablePath(item)

    this.viewer.loadModel(path)

    this.react.setState({
      activeItem: item
    })
  }
}

完整的代碼如下所示，對這功能有興趣的朋友們可以通過這個網址 https://forge-rcdb.autodesk.i...，并載入 Viewable Selector 來體驗。

/////////////////////////////////////////////////////////
// Viewing.Extension.ViewableSelector
// by Philippe Leefsma, November 2017
//
/////////////////////////////////////////////////////////
import MultiModelExtensionBase from "Viewer.MultiModelExtensionBase"
import "./Viewing.Extension.ViewableSelector.scss"
import WidgetContainer from "WidgetContainer"
import ReactTooltip from "react-tooltip"
import ServiceManager from "SvcManager"
import Toolkit from "Viewer.Toolkit"
import ReactDOM from "react-dom"
import Image from "Image"
import Label from "Label"
import React from "react"

class ViewableSelectorExtension extends MultiModelExtensionBase {

  /////////////////////////////////////////////////////////
  // Class constructor
  //
  /////////////////////////////////////////////////////////
  constructor (viewer, options) {

    super (viewer, options)

    this.react = options.react
  }

  /////////////////////////////////////////////////////////
  //
  //
  /////////////////////////////////////////////////////////
  get className() {

    return "viewable-selector"
  }

  /////////////////////////////////////////////////////////
  // Extension Id
  //
  /////////////////////////////////////////////////////////
  static get ExtensionId() {

    return "Viewing.Extension.ViewableSelector"
  }

  /////////////////////////////////////////////////////////
  // Load callback
  //
  /////////////////////////////////////////////////////////
  load () {

    this.react.setState({

      activeItem: null,
      items: []

    }).then (async() => {

      const urn = this.options.model.urn

      this.viewerDocument =
        await this.options.loadDocument(urn)

      const items =
        await Toolkit.getViewableItems(
          this.viewerDocument)

      if (items.length > 1) {

        this.createButton()

        await this.react.setState({
          activeItem: items[0],
          items: [items[0], items[1], items[2]]
        })

        if (this.options.showPanel) {

          this.showPanel (true)
        }
      }
    })

    console.log("Viewing.Extension.ViewableSelector loaded")

    return true
  }

  /////////////////////////////////////////////////////////
  // Unload callback
  //
  /////////////////////////////////////////////////////////
  unload () {

    this.react.popViewerPanel(this)

    console.log("Viewing.Extension.ViewableSelector unloaded")

    return true
  }

  /////////////////////////////////////////////////////////
  // Load the selected viewable
  //
  /////////////////////////////////////////////////////////
  onItemSelected (item) {

    const {activeItem} = this.react.getState()

    if (item.guid !== activeItem.guid) {

      this.viewer.tearDown()

      this.viewer.start()

      const path =
        this.viewerDocument.getViewablePath(item)

      this.viewer.loadModel(path)

      this.react.setState({
        activeItem: item
      })
    }
  }

  /////////////////////////////////////////////////////////
  // Create a button to display the panel
  //
  /////////////////////////////////////////////////////////
  createButton () {

    this.button = document.createElement("button")

    this.button.title = "This model has multiple views ..."

    this.button.className = "viewable-selector btn"

    this.button.innerHTML = "Views"

    this.button.onclick = () => {

      this.showPanel(true)
    }

    const span = document.createElement("span")

    span.className = "fa fa-list-ul"

    this.button.appendChild(span)

    this.viewer.container.appendChild(this.button)
  }

  /////////////////////////////////////////////////////////
  // Show/Hide panel
  //
  /////////////////////////////////////////////////////////
  showPanel (show) {

    if (show) {

      const {items} = this.react.getState()

      this.button.classList.add("active")

      const container = this.viewer.container

      const height = Math.min(
        container.offsetHeight - 110,
        (items.length + 1)  * 78 + 55)

      this.react.pushViewerPanel(this, {
        maxHeight: height,
        draggable: false,
        maxWidth: 500,
        minWidth: 310,
        width: 310,
        top: 30,
        height
      })

    } else {

      this.react.popViewerPanel(this.id).then(() => {

        this.button.classList.remove("active")
      })
    }
  }

  /////////////////////////////////////////////////////////
  // Render React panel content
  //
  /////////////////////////////////////////////////////////
  renderContent () {

    const {activeItem, items} = this.react.getState()

    const urn = this.options.model.urn

    const apiUrl = this.options.apiUrl

    const domItems = items.map((item) => {

      const active = (item.guid === activeItem.guid)
        ? " active" :""

      const query = `size=400&guid=${item.guid}`

      const src = `${apiUrl}/thumbnails/${urn}?${query}`

      return (
        
 this.onItemSelected(item)}>
          

            
          
          
            

              
            
          
          
        
      )
    })

    return (
      

        {domItems}
        

      
    )
  }

  /////////////////////////////////////////////////////////
  // Render title
  //
  /////////////////////////////////////////////////////////
  renderTitle () {

    return (
      

        
          Select Viewable
        
        

           this.showPanel(false)}
            title="Toggle panel">
            
          
        
      
    )
  }

  /////////////////////////////////////////////////////////
  // Render main
  //
  /////////////////////////////////////////////////////////
  render (opts) {

    return (
       this.renderTitle(opts.docked)}
        showTitle={opts.showTitle}
        className={this.className}>
        {this.renderContent()}
      
    )
  }
}

Autodesk.Viewing.theExtensionManager.registerExtension(
  ViewableSelectorExtension.ExtensionId,
  ViewableSelectorExtension)