Project Version 2017.4 (#1173)

* Make project version 2017.4 * updated the documentation * added the upgrade notes for 2017.1 to 2017.4 * removed the .10f1 * fix the typo and make the language nicer * resolved the comments * Wrapping lines. * Wording. * resolved part of jeff's comment * resolved part of jeff's comment * fixed the link * Update FAQ.md Missing "an". * Missing "an".
6 年前 · 24796cf6
--- a/UnitySDK/ProjectSettings/ProjectSettings.asset
+++ b/UnitySDK/ProjectSettings/ProjectSettings.asset
 --- !u!129 &1
 PlayerSettings:
  m_ObjectHideFlags: 0
-  serializedVersion: 12
+  serializedVersion: 14
+  AndroidFilterTouchesWhenObscured: 0
  defaultScreenOrientation: 4
  targetDevice: 2
  useOnDemandResources: 0
    width: 1
    height: 1
  m_SplashScreenLogos: []
-  m_SplashScreenBackgroundLandscape: {fileID: 0}
-  m_SplashScreenBackgroundPortrait: {fileID: 0}
  m_VirtualRealitySplashScreen: {fileID: 0}
  m_HolographicTrackingLossScreen: {fileID: 0}
  defaultScreenWidth: 1024
  m_StereoRenderingPath: 0
  m_ActiveColorSpace: 0
  m_MTRendering: 1
-  m_MobileMTRendering: 0
  m_StackTraceTypes: 010000000100000001000000010000000100000001000000
  iosShowActivityIndicatorOnLoading: -1
  androidShowActivityIndicatorOnLoading: -1
  allowedAutorotateToLandscapeLeft: 1
  useOSAutorotation: 1
  use32BitDisplayBuffer: 1
+  preserveFramebufferAlpha: 0
+  androidBlitType: 0
+  macRetinaSupport: 1
+  deferSystemGesturesMode: 0
+  hideHomeButton: 0
  submitAnalytics: 1
  usePlayerLog: 1
  bakeCollisionMeshes: 1
  allowFullscreenSwitch: 1
  graphicsJobMode: 0
  macFullscreenMode: 2
-  d3d9FullscreenMode: 1
+  metalFramebufferOnly: 0
-  ignoreAlphaClear: 0
+  xboxOneSResolution: 0
+  xboxOneXResolution: 3
+  xboxOnePresentImmediateThreshold: 0
  videoMemoryForVertexBuffers: 0
  psp2PowerMode: 0
  psp2AcquireBGM: 1
  bundleVersion: 1.0
  preloadedAssets: []
  metroInputSource: 0
+  wsaTransparentSwapchain: 0
  m_HolographicPauseOnTrackingLoss: 1
  xboxOneDisableKinectGpuReservation: 0
  xboxOneEnable7thCore: 0
    daydream:
      depthFormat: 0
      useSustainedPerformanceMode: 0
+      enableVideoLayer: 0
+      useProtectedVideoMemory: 0
+      minimumSupportedHeadTracking: 0
+      maximumSupportedHeadTracking: 1
+      depthBufferSharingEnabled: 0
+    oculus:
+      sharedDepthBuffer: 0
+      dashSupport: 0
+  m_ColorGamuts: 00000000
+  androidSupportedAspectRatio: 1
+  androidMaxAspectRatio: 2.1
  applicationIdentifier:
    Android: com.Vince.Ball
  buildNumber:
  iPhone47inSplashScreen: {fileID: 0}
  iPhone55inPortraitSplashScreen: {fileID: 0}
  iPhone55inLandscapeSplashScreen: {fileID: 0}
+  iPhone58inPortraitSplashScreen: {fileID: 0}
+  iPhone58inLandscapeSplashScreen: {fileID: 0}
+  appleTVSplashScreen2x: {fileID: 0}
+  tvOSSmallIconLayers2x: []
+  tvOSTopShelfImageLayers2x: []
+  tvOSTopShelfImageWideLayers2x: []
  iOSLaunchScreenType: 0
  iOSLaunchScreenPortrait: {fileID: 0}
  iOSLaunchScreenLandscape: {fileID: 0}
  iOSLaunchScreeniPadFillPct: 100
  iOSLaunchScreeniPadSize: 100
  iOSLaunchScreeniPadCustomXibPath: 
+  iOSUseLaunchScreenStoryboard: 0
+  iOSLaunchScreenCustomStoryboardPath: 
  iOSDeviceRequirements: []
  iOSURLSchemes: []
  iOSBackgroundModes: 0
  iOSManualSigningProvisioningProfileID: 
  tvOSManualSigningProvisioningProfileID: 
  appleEnableAutomaticSigning: 0
+  clonedFromGUID: 00000000000000000000000000000000
  AndroidTargetDevice: 0
  AndroidSplashScreenScale: 0
  androidSplashScreen: {fileID: 0}
  AndroidIsGame: 1
+  AndroidEnableTango: 0
+  androidUseLowAccuracyLocation: 0
  m_AndroidBanners:
  - width: 320
    height: 180
    m_APIs: 1100000010000000
    m_Automatic: 0
  m_BuildTargetVRSettings: []
+  m_BuildTargetEnableVuforiaSettings: []
-  webPlayerTemplate: APPLICATION:Default
+  mobileMTRendering:
+    Android: 1
+    iPhone: 1
+    tvOS: 1
+  m_BuildTargetGroupLightmapEncodingQuality:
+  - m_BuildTarget: Standalone
+    m_EncodingQuality: 1
+  - m_BuildTarget: XboxOne
+    m_EncodingQuality: 1
+  - m_BuildTarget: PS4
+    m_EncodingQuality: 1
  wiiUTitleID: 0005000011000000
  wiiUGroupID: 00010000
  wiiUCommonSaveSize: 4096
  switchTitleNames_9: 
  switchTitleNames_10: 
  switchTitleNames_11: 
+  switchTitleNames_12: 
+  switchTitleNames_13: 
+  switchTitleNames_14: 
  switchPublisherNames_0: 
  switchPublisherNames_1: 
  switchPublisherNames_2: 
  switchPublisherNames_9: 
  switchPublisherNames_10: 
  switchPublisherNames_11: 
+  switchPublisherNames_12: 
+  switchPublisherNames_13: 
+  switchPublisherNames_14: 
  switchIcons_0: {fileID: 0}
  switchIcons_1: {fileID: 0}
  switchIcons_2: {fileID: 0}
  switchIcons_9: {fileID: 0}
  switchIcons_10: {fileID: 0}
  switchIcons_11: {fileID: 0}
+  switchIcons_12: {fileID: 0}
+  switchIcons_13: {fileID: 0}
+  switchIcons_14: {fileID: 0}
  switchSmallIcons_0: {fileID: 0}
  switchSmallIcons_1: {fileID: 0}
  switchSmallIcons_2: {fileID: 0}
  switchSmallIcons_9: {fileID: 0}
  switchSmallIcons_10: {fileID: 0}
  switchSmallIcons_11: {fileID: 0}
+  switchSmallIcons_12: {fileID: 0}
+  switchSmallIcons_13: {fileID: 0}
+  switchSmallIcons_14: {fileID: 0}
  switchManualHTML: 
  switchAccessibleURLs: 
  switchLegalInformation: 
  switchLocalCommunicationIds_7: 
  switchParentalControl: 0
  switchAllowsScreenshot: 1
+  switchAllowsVideoCapturing: 1
+  switchAllowsRuntimeAddOnContentInstall: 0
  switchDataLossConfirmation: 0
  switchSupportedNpadStyles: 3
  switchSocketConfigEnabled: 0
  switchUdpSendBufferSize: 9
  switchUdpReceiveBufferSize: 42
  switchSocketBufferEfficiency: 4
+  switchSocketInitializeEnabled: 1
+  switchNetworkInterfaceManagerInitializeEnabled: 1
+  switchPlayerConnectionEnabled: 1
  ps4NPAgeRating: 12
  ps4NPTitleSecret: 
  ps4NPTrophyPackPath: 
  ps4PronunciationSIGPath: 
  ps4BackgroundImagePath: 
  ps4StartupImagePath: 
+  ps4StartupImagesFolder: 
+  ps4IconImagesFolder: 
  ps4SaveDataImagePath: 
  ps4SdkOverride: 
  ps4BGMPath: 
  n3dsTitle: GameName
  n3dsProductCode: 
  n3dsApplicationId: 0xFF3FF
-  stvDeviceAddress: 
-  stvProductDescription: 
-  stvProductAuthor: 
-  stvProductAuthorEmail: 
-  stvProductLink: 
-  stvProductCategory: 0
  XboxOneProductId: 
  XboxOneUpdateKey: 
  XboxOneSandboxId: 
  XboxOneSplashScreen: {fileID: 0}
  XboxOneAllowedProductIds: []
  XboxOnePersistentLocalStorageSize: 0
+  XboxOneXTitleMemory: 8
  xboxOneScriptCompiler: 0
  vrEditorSettings:
    daydream:
--- a/UnitySDK/ProjectSettings/ProjectVersion.txt
+++ b/UnitySDK/ProjectSettings/ProjectVersion.txt
-m_EditorVersion: 2017.1.5f1
+m_EditorVersion: 2017.4.10f1
--- a/docs/FAQ.md
+++ b/docs/FAQ.md
 without the ENABLE_TENSORFLOW flag, refer to [Setting Up The ML-Agents Toolkit
 Within Unity](Installation.md#setting-up-ml-agent-within-unity) for solution.

-## TensorFlow epsilon placeholder error
+## Instance of CoreBrainInternal couldn't be created
+
+If you try to use ML-Agents in Unity versions 2017.1 - 2017.3, you might
+encounter an error that looks like this:
+
+```console 
+Instance of CoreBrainInternal couldn't be created. The the script
+class needs to derive from ScriptableObject.
+UnityEngine.ScriptableObject:CreateInstance(String)
+```
+
+You can fix the error by removing `CoreBrain` from CoreBrainInternal.cs:16,
+clicking on your Brain Gameobject to let the scene recompile all the changed
+C# scripts, then adding the `CoreBrain` back. Make sure your brain is in
+Internal mode, your TensorFlowSharp plugin is imported and the
+ENABLE_TENSORFLOW flag is set. This fix is only valid locally and unstable.
+
+## Tensorflow epsilon placeholder error

 If you have a graph placeholder set in the Internal Brain inspector that is not
 present in the TensorFlow graph, you will see some error like this:
--- a/docs/Installation.md
+++ b/docs/Installation.md
 install Python with additional dependencies. Each of the subsections below
 overviews each step, in addition to a Docker set-up.

-## Install **Unity 2017.1** or Later
+## Install **Unity 2017.4** or Later

 [Download](https://store.unity.com/download) and install Unity. If you would
 like to use our Docker set-up (introduced later), make sure to select the _Linux
--- a/docs/Migrating.md
+++ b/docs/Migrating.md
  packages, `mlagents.env` and `mlagents.trainers`. `mlagents.env` can be used
  to interact directly with a Unity environment, while `mlagents.trainers`
  contains the classes for training agents.
+* The supported Unity version has changed from `2017.1 or later` to `2017.4
+  or later`. 2017.4 is an LTS (Long Term Support) version that helps us
+  maintain good quality and support. Earlier versions of Unity might still work,
+  but you may encounter an
+  [error](FAQ.md#instance-of-corebraininternal-couldnt-be-created) listed here. 

 ### Unity API

--- a/docs/Using-TensorFlow-Sharp-in-Unity.md
+++ b/docs/Using-TensorFlow-Sharp-in-Unity.md

 ## Requirements

-* Unity 2017.1 or above
+* Unity 2017.4 or above
 * Unity TensorFlow Plugin ([Download here](https://s3.amazonaws.com/unity-ml-agents/0.4/TFSharpPlugin.unitypackage))

 ## Using TensorFlowSharp with ML-Agents