Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
products:m28:devel [2017/03/08 22:39]
fk0724 [about developer kit]
products:m28:devel [2017/03/29 11:01] (current)
fk0724 [when you release your development]
Line 7: Line 7:
 ====== about developer kit ====== ====== about developer kit ======
  
-Thank you for purchase [[::projects:m28|M28]].+Thank you for purchase [[::products:m28|M28]].
  
 M28 does not drive by itself. However we have bundled a developer kit so that everyone who purchased can make themselves additional functions, and sell, distribute and introduce easily. M28 does not drive by itself. However we have bundled a developer kit so that everyone who purchased can make themselves additional functions, and sell, distribute and introduce easily.
Line 24: Line 24:
  
 ==== try our development sample out ==== ==== try our development sample out ====
-You find [[analogmatic|AnalogMatic for M28]] in the package of M28. This is our development in order to show you how VIAS works. After you install it, you can take your friend out with M28. We added 2 scripts and associate them with VIAS.+[[analogmatic|AnalogMatic for M28]] is our development in order to show you how VIAS works. After you install it, you can take your friend out with M28. We added 2 scripts and associate them with VIAS.
  
 **AnalogMatic for M28** … object\\ **AnalogMatic for M28** … object\\
Line 35: Line 35:
 See [[analogmatic|this page]] and install it. See [[analogmatic|this page]] and install it.
  
 +==== 3rd party showcase ====
 +Please tell me when you release your development. We introduce your works here.
 +
 + >>​ [[products/​m28/​3rd_party_showcase]]
 ===== development information ===== ===== development information =====
 Make link both **developer kit** and **M28** by the same procedure as [[analogmatic|AnalogMatic]]. After that, add scripts, animation, sound, etc and send link message from the script according to the following API to control M28. Make link both **developer kit** and **M28** by the same procedure as [[analogmatic|AnalogMatic]]. After that, add scripts, animation, sound, etc and send link message from the script according to the following API to control M28.
Line 49: Line 53:
 By separating interfaces and physical engines and standardizing the specifications of car control scripts, the following advantages are generated for third-party developers. By separating interfaces and physical engines and standardizing the specifications of car control scripts, the following advantages are generated for third-party developers.
  
-<WRAP center round important 60%+  * can divert engine script once developed 
-translating from [[devel_ja|Japanese]] +  * can develop scripts without considering difficult parts such as linkage 
-</WRAP>+  * also creators who are not modeler can partly participate in development 
 + 
 +Further, as the number of developers who adopt this mechanism increases, the following advantages are created for users. 
 + 
 +  * with one ride, they can try different operating methods and different ride comfort 
 +  * only necessary functions can be selected and used according to time or place 
 + 
 +==== VIAS API ==== 
 +All transmission / reception is done with link message. 
 + 
 +<code lsl2
 +integer ApiVersion;​ 
 +  
 +SendAPICommand(string command, integer value){ // transmission 
 +    llMessageLinked(LINK_ROOT,​ value, command, ""​);​ 
 +
 +  
 +default{ 
 +    state_entry(){ 
 +        SendAPICommand("​VERSION",​ 0); 
 +    } 
 +  
 +    link_message(integer sender, integer value, string response, key id){ // reception 
 +        if (response == "​VIAS-M28"​){ 
 +            ApiVersion = value; 
 +        } 
 +        else if (llGetSubString(response,​ 0, 3) == "​VIAS"​){ 
 +            llSay(0, "[ERROR] does not correspond to this model"​);​ 
 +        } 
 +    } 
 +
 +</​code>​ 
 + 
 + 
 +^  API ver.  ^  command ​ ^  value  ^  説明 ​ ^ 
 +|  1.0  |  VERSION ​ |  ---  | Query API version. In response to the inquiry, the following reply will be made.\\  response = "​VIAS-M28"​ ... To [[sl>​LINK_THIS]],​ assign a value obtained by multiplying value by 10 times and return it. In the case of ver.1.0, value = 10 is returned.| 
 +|  1.0  |  RESET  |  0  | Discard variables related to vehicle body control held by VIAS and restore the following initial state.\\  LEFT = 0\\  SPEED = 0\\  GEAR = 0\\  PARKING = 1| 
 +|  :::  |  :::  |  1  | Reboot VIAS. With this command, VIAS starts the installation work; moves and rotates each link prim to the prescribed position. After reboot, the following reply will be made.\\  response = "​SEAT"​ ... To [[sl>​LINK_SET]], returns the link number of SEAT. You may use this number as the passenger'​s sit target.\\  response = "​INIT"​ ... To [[sl>​LINK_SET]],​ returns the boolean whether succeed installing or not.| 
 +|  1.0  |  ENGINE ​ |  0  | Stop engine sound. | 
 +|  :::  |  :::  |  1  | Play engine sound.| 
 +|  1.0  |  TEXT  |  0  | Text off.| 
 +|  :::  |  :::  |  1  | Text on.| 
 +|  1.0  |  LEFT  |  -200 〜 200  | Turn handle left and rotate front wheels. ex) LEFT = -127 means turning right 12.7 degrees.| 
 +|  1.0  |  SPEED  |  -100 〜 100  | Changes "Speed : xx%" on the text and wheels rotate. When SPEED 0, changes the Gear "​R"​ on the text. VIAS does not have any physical parameters so car would not run with this command.| 
 +|  1.0  |  GEAR  |  0 〜 4  | Changes "Gear : n" on the text and move shifter.| 
 +|  1.0  |  PARKING ​ |  0  | Hides "​P-Brake : ON" on the text.| 
 +|  :::  |  :::  |  1  | Shows "​P-Brake : ON" on the text.| 
 +|  1.0  |  LIGHT  |  0  | head light = OFF side lights = OFF | 
 +|  :::  |  :::  |  1  | head light = ON / side lights = OFF | 
 +|  :::  |  :::  |  2  | head light = OFF / side lights = ON | 
 +|  :::  |  :::  |  3  | head light = ON / side lights = ON | 
 +|  1.0  |  BRAKE  |  0  | Brake lamps OFF.| 
 +|  :::  |  :::  |  1  | Brake lamps ON.| 
 +|  :::  |  COVER  |  0  | Hides engine cover.| 
 +|  :::  |  :::  |  1  | Shows engine cover.| 
 + 
 +===== when you release your development ===== 
 +==== the name ==== 
 +You need not use "​anhelo"​ or "​VIAS"​ in your development name. 
 +==== poses ==== 
 +If you don't use the poses "​m28driverbasepose.bvh"​ and "​m28passengerbasepose.bvh",​ please kill them from the inventory. 
 +==== permission ==== 
 +Customers have to make link between M28 and your development. So you should release it as modifyable. 
 +==== remarks on your AD ==== 
 +Customers have to purchase M28 from anhelo when they use your development. So you should add that remarks on your AD. Our main store is [[http://​maps.secondlife.com/​secondlife/​Kishijoten/​185/​45/​720|here]]. Please add this LM in your package. 
 +==== after releasing ==== 
 +Please tell me about 
 +  * SLURL of your shop 
 +  * about your development 
 +  * price 
 +  * whether DEMO available or not 
 +  * your avatar name and your shop name 
 +We will publish about your development through 
 +  * in-world group notice 
 +  * subscriber kiosk system 
 +  * [[products/​m28/​3rd_party_showcase|our web site]] 
 +  * our main store 
 +  * SNS such as twitter, Facebook and so on