Configuration Loading with a JSON Object Reference

You can use a JSON object to define several player configuration settings. Using a JSON object to define player configuration settings offers several benefits:

• Maintenance: Allows making player changes without resubmitting the app to the App Store
• Efficient Development: Facilitates defining player configuration settings through a single builder method
• Caching: Permits caching player configurations in memory or on a web server

---

Load a JSON Configuration

Use the following steps to initialize a player with a JSON configuration:

1. Define a JSON object.

   Format	Description
   data Data	Enables caching a data blob downloaded from your own web service and allows the iOS SDK to deserialize the JSON This is a data blob that contains serialized JSON. Using this format removes the need for you to convert the Data to a JSONObject yourself.
   json [String : Any]	Enables creating the JSON as a dictionary within the code

2. Through JWPlayerConfigurationBuilder(), load a JSON configuration to configure the player.

   datajson

   // build your config
   do {
    // This step could be done in your application as preloading,
    // and stored in memory.
    let url = URL(string:"url_of_your_config")!
    let jsonData = Data(contentsOf: url)
   
    // Create the config
    let config = try builder.configuration(data: jsonData).build()
    player.configurePlayer(with: config)
   } catch {
       // Handle build errors
   }
   

   // build your config
   do {
    let json: JSONObject = [
      "file": "yourvideo.mp4",
      "title": "video title"
    ]
    let config = try builder.configuration(json: json).build()
    player.configurePlayer(with: config)
   } catch {
       // Handle build errors
   }
   

---

iOS Specific Properties

The iOS SDK has support for the following properties.

(root)

externalMetadata

externalPlaybackSettings

Captions

The iOS SDK supports all captions options.