Capabilities/fr
From OpenSimulator
(→Capacités) |
(→Activation et désactivation) |
||
| Line 158: | Line 158: | ||
==Activation et désactivation== | ==Activation et désactivation== | ||
| − | Les capacités sont activées et désactivées dans OpenSimulator en paramètrant une propriété avec le nom Cap_<attachment-name> dans la section [ClientStack.LindenCaps] d'OpenSim.ini. | + | Les capacités sont activées et désactivées dans OpenSimulator en paramètrant une propriété avec le nom Cap_<attachment-name> dans la section [ClientStack.LindenCaps] d'OpenSim.ini. Les paramètres par défaut sont présents dans le fichier OpenSimDefaults.ini |
| + | |||
| + | La valeur peut être : | ||
| + | * "" (ou la propriété capability n'est présente dans aucun fichier ini), le service est désactivé. | ||
| + | * "localhost", le service est fourni par le simulateur | ||
| + | * une URL valide, le service est fourni par un serveur externe. | ||
Par exemple pour désactiver la capacité GetTexture on peut définir : | Par exemple pour désactiver la capacité GetTexture on peut définir : | ||
Revision as of 05:08, 31 March 2021
 |
Languages: |
|
Contents |
Introduction
Les capacités font partie du protocole de communication entre un client et la région. Elles correspondent à une URL HTTP qu'un client utilisera pour effectuer une action particulière, par exemple obtenir des données de texture. Une région peut fournir le service pour une capacité, en fournissant son URL pour celle-ci, fournir l'URL d'un service externe ou l'ignorer si elle n'est pas supportée.
Opensimulator prend en charge une partie des capacités que les viewers tiers attendent de Second Life, ainsi que ses propres capacités.
Capacités d'OpenSimulator
Il s'agit de capacités qu'une région OpenSimulator peut configurer pour chaque client. Notez que cette liste dépend de la version, et peut ne pas être à jour.
SEED la capacité de démarrage
Les viewers se connectent au service avec une liste des capacités dont ils ont besoin et le service répond avec la liste des URL des capacités qu'il prend en charge.
Certaines informations au sujet du viewer ou de la région peuvent également être incluses dans la demande ou la réponse et certaines URL de réponse peuvent contenir des parties uniques pour le client courant et la région.
Autres capacités
| Nom | Description |
|---|---|
| AttachmentResources | semble être associé à la détermination de limites sur les scripts des attachements des agents. |
| AvatarPickerSearch | |
| ChatSessionRequest | |
| CopyInventoryFromNotecard | |
| DispatchRegionInfo | |
| EstateAccess | |
| EstateChangeInfo | |
| EnvironmentSetting | |
| EventQueueGet | utilisé pour la file d'attente des événements. |
| FetchInventory | obsolète |
| FetchInventory2 | voir Capacités d'inventaire |
| FetchInventoryDescendents2 | voir Capacités d'inventaire |
| FetchLib2 | voir Capacités d'inventaire |
| FetchLibDescendents2 | voir Capacités d'inventaire. |
| FetchLib | Obsolète |
| FetchLibDescendents | Obsolète |
| GetDisplayNames | |
| GetMesh | utilisé pour obtenir les données de mesh. |
| GetMesh2 | utilisé pour obtenir les données de mesh. |
| GetObjectCost | |
| GetObjectPhysicsData | |
| GetTexture | utilisé pour obtenir les données de textures via HTTP à la place de UDP. |
| GroupMemberData | |
| GroupProposalBallot | |
| HomeLocation | |
| LandResources | |
| MapLayer | |
| MapLayerGod | |
| NewFileAgentInventory | |
| NewFileAgentInventoryVariablePrice | |
| ObjectAdd | |
| ObjectMedia | utilisé pour obtenir des informations sur les média sur une primitive (MOAP)/texture de partage de media/surface. |
| ObjectMediaNavigate | utilisé pour changer les pages web, etc., sur une surface de MOAP |
| ParcelPropertiesUpdate | |
| ParcelMediaURLFilterList | |
| ParcelNavigateMedia | |
| ParcelVoiceInfoRequest | |
| ProductInfoRequest | |
| ProvisionVoiceAccountRequest | |
| RemoteParcelRequest | |
| RequestTextureDownload | |
| SearchStatRequest | |
| SearchStatTracking | |
| SendPostcard | |
| SendUserReport | |
| SendUserReportWithScreenshot | |
| ServerReleaseNotes | |
| SetDisplayName | |
| SimConsoleAsync | utilisé pour la console du simulateur. |
| SimulatorFeatures | utilisé pour obtenir des information à propos des fonctionnalités des simulateurs disponibles. Voir SimulatorFeatures/fr pour plus d'informations. |
| StartGroupProposal | |
| TextureStats | |
| UntrustedSimulatorMessage | |
| UpdateAgentInformation | |
| UpdateAgentLanguage | |
| UpdateGestureAgentInventory | |
| UpdateNotecardAgentInventory | |
| UpdateScriptAgent | |
| UpdateGestureTaskInventory | |
| UpdateNotecardTaskInventory | |
| UpdateScriptTask | |
| UploadBakedTexture | utilisé pour charger les textures (baked) d'avatar via HTTP plutôt qu'UDP |
| UploadObjectAsset | |
| ViewerAsset | Recherche principale pour tous les assets, remplace les méthodes llUDP, et caps GetTexture, GetMesh et GetMesh2.
ATTENTION : FireStorm version 6.0.2 ne gère pas ceci sous une forme compatible avec opensimulator. Si l'utilisation de cette version du viewer est nécessaire, ceci doit être désactivé. |
| ViewerStartAuction | |
| ViewerStats | utilisé pour chargerles statistiques du viewer (utilisation cpu, fps, etc.) |
| WebFetchInventoryDescendents | Obsolète |
Activation et désactivation
Les capacités sont activées et désactivées dans OpenSimulator en paramètrant une propriété avec le nom Cap_<attachment-name> dans la section [ClientStack.LindenCaps] d'OpenSim.ini. Les paramètres par défaut sont présents dans le fichier OpenSimDefaults.ini
La valeur peut être :
- "" (ou la propriété capability n'est présente dans aucun fichier ini), le service est désactivé.
- "localhost", le service est fourni par le simulateur
- une URL valide, le service est fourni par un serveur externe.
Par exemple pour désactiver la capacité GetTexture on peut définir :
[ClientStack.LindenCaps] Cap_GetTexture = ""
et pour l'activer
[ClientStack.LindenCaps] Cap_GetTexture = "localhost"
Il y a aussi un grand nombre de capacités définies par défaut dans le fichier OpenSimDefaults.ini. Comme pour les autres configurations, elles peuvent être écrasées par ce que vous allez ajouter dans le fichier OpenSim.ini.
Mécanisme
Ceci est une brève description du mécanisme par lequel un viewer qui entre dans une région obtient des paramètres de capacité à sa première connexion. Le mécanisme est légèrement différent quand un utilisateur se déplace entre les régions après la connexion - cela n'a pas encore été documenté.
- Le client fait une requête de connexion au service de connexion de l'installation.
- Le service de connexion génère la seed (graine) capacité. C'est un URL avec une composante aléatoire qui est mis à disposition par le simulateur qui héberge la destination de connexion. L'URL est fournie au viewer et forme une partie de la réponse de connexion (seed_capability).
Voir SimulatorLoginProtocol pour plus de détails.
- Le client établit une connexion enfant initilae avec le simulateur à l'aide du message UDP UseCircuitCode. Le serveur déclenche des modules individuels pour enregistrer les capacités selon les besoins (par exemple le module GetTextureModule enregistre une capacité GetTexture, etc.à. Comme prédédemment, ces capacités on une composante aléatoire.
- Le client envoie une requête à la seed capacité définie auparavant. La requête demande un ensemble de capacités(GetTexture, etc.). Le simulateur répond avec les URLs de capacités requises.
- Le client peut alors envoyer des requêtes aux capacités spécifiques.
Vous pouvez afficher la configuration des capacités avec la commande de console de simulateur "show caps list". Ci-dessous quelques exemples pour cette commande :
OpenSim (root)# show caps list Region keynote1: ** User f2f493c0-27d3-4cf2-be97-b44dfdad13b6: ObjectAdd /CAPS/OA/222dd805-a8f4-474a-a80b-530ab798f448/ NewFileAgentInventory /CAPS/e3a0dbd7-3e00-4134-87f4-ebf9350ce8440002/ FetchInventory2 /CAPS/08303040-e059-43e5-b6dc-882b40b3d117 UpdateAgentInformation /CAPS/e3a0dbd7-3e00-4134-87f4-ebf9350ce8440500/ GetTexture /CAPS/2389a354-033b-416c-8fc5-f2200837eac8/ GetObjectPhysicsData /CAPS/e3a0dbd7-3e00-4134-87f4-ebf9350ce8440101/ UpdateScriptAgent /CAPS/e3a0dbd7-3e00-4134-87f4-ebf9350ce8440004/ SimulatorFeatures /CAPS/a7551043-30a8-4abe-b5f6-1185a6b20187 SimConsoleAsync /CAPS/4e885802-ed6a-472a-9261-276f049b4dc7/ EnvironmentSettings /CAPS/0020/344f07cd-88f8-4a28-8bd2-689a238c7f10 RemoteParcelRequest /CAPS/e3a0dbd7-3e00-4134-87f4-ebf9350ce8440009/ AvatarPickerSearch /CAPS/38dfa1b4-b76a-4301-b8d2-91894b4e5365/ UploadObjectAsset /CAPS/OA/60ca2175-ee34-4cfc-bbf9-e81992147ffc/ SEED /CAPS/e3a0dbd7-3e00-4134-87f4-ebf9350ce8440000/ UpdateNotecardAgentInventory /CAPS/e3a0dbd7-3e00-4134-87f4-ebf9350ce8440004/ CustomMenuAction /CAPS/3b02708e-92e3-4106-92a5-88aaf7407e4e/ UpdateScriptAgentInventory /CAPS/e3a0dbd7-3e00-4134-87f4-ebf9350ce8440004/ ObjectMedia /CAPS/bfb392c6-8559-4dab-a464-1da263b85a89 UpdateScriptTask /CAPS/e3a0dbd7-3e00-4134-87f4-ebf9350ce8440005/ ParcelPropertiesUpdate /CAPS/2691b05e-58b3-4355-b121-a2fb83d21a20 MapLayer /CAPS/e3a0dbd7-3e00-4134-87f4-ebf9350ce8440001/ NewFileAgentInventoryVariablePrice /CAPS/7585a3dc-4c96-4ec2-9e13-935d17ef17a0 UpdateScriptTaskInventory /CAPS/e3a0dbd7-3e00-4134-87f4-ebf9350ce8440005/ ViewerStats /CAPS/VS/dae0e09f-a171-474d-8f1e-0af09afb7d80 UntrustedSimulatorMessage /CAPS/1aeae93a-67b0-4f57-ad87-eefc24436d4c MeshUploadFlag /CAPS/d9f7a6eb-1967-4da8-85ae-051ea4fd06f7 UploadBakedTexture /CAPS/e3a0dbd7-3e00-4134-87f4-ebf9350ce8440010/ CopyInventoryFromNotecard /CAPS/e3a0dbd7-3e00-4134-87f4-ebf9350ce8440007/ GetMesh /CAPS/90f9a679-0b97-40a6-b089-1eaaf3dbb3ef/ ObjectMediaNavigate /CAPS/f0e2080d-35a5-46a7-a2ad-eff77e9c52e3 EventQueueGet /CAPS/EQG/1267ddf0-13fb-4d5f-bc20-2cb20be1c6d6/ FetchInventoryDescendents2 /CAPS/2ba79e1c-e9ba-45af-97e4-5b5757a25418/
Ici, la capacité SEED est la capacité initiale à partir de laquelle viennent les autres requêtes.
Il y a des configurations avancées qui peuvent servir les capacités directement depuis les services (voir la section ci-dessous pour plus de détails). Cependant, ces configurations ne peuvent pas encore générer de composante aléatoire. Dans le futur,un mécanisme qui permettrait cela pourrait exister au pris d'une augmentation de la complexité du système.
Servir des capacités depuis les services
Normalement, les capacités sont servies depuis le simulateur. Cependant, pour le service GetTexture (et plus dans le futur, comme pour le service GetMesh), la requ$ete peut être traitée directement depuis une instance d'exploitation d'un service Robust sur un port accessible par le viewer. Voir Direct Service Requests pour avoir plus d'informations à ce sujet.
