Differences
This shows you the differences between two versions of the page.
| 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 | ||